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From the Editor 


A s this issue is going to press, MacTech just announced the very first MacTech Technical 
Conference. Set to take place November 3-5 in Los Angeles, California, this is going to 
be a special few days. We’re just about to announce speakers and general line up, which 
should be done once you receive this issue in the mail. If you w^ould like to share your 
knowledge and solutions with your peers, please submit a speaker application 

As a speaker or attendee, we hope you1l clear your 

calendar and join us for this amazing event. 

The idea of tlie show Ls to present topics that will be new to you, challenge you and inspire 
you. There will be many opportunities to meet your peers and exchange ideas. The MacTech 
Conference will provide learning beyond the technology. Keep an eye on 
http/AAvw.mcKfedi.cnnyfe^ and @mactechconf on Twitter, 

This month, our cover story features a new monthly column: CoreSec. All aspects of 
computer security are only becoming more relevant to all computer users, both professional and 
recreational. Mac OS X is not excluded from tfte many securiry issues that face us. Mike 
Hj6rleifs.st)n brings his experti.se to guide us through the minefield of tenns, options and 
exploits. 

We all love the new^ shiny from Apple. However, what happens when, as a company, Apple 
does something you may not agree with? Of if it seems like Apple is ""gelling too big?" Bloggers 
have been accusing Apple of becoming like Microsoft, but Apple fans see it differently. Of 
course, the reality is somewhere in-betw'een. Michael Swaine taps into tliis trend with, *"Oh Noes! 
Apple is Turning into the Borg!" 

Jose Cruz continues his article on WTiting a Gift front-end for the commandftine gii-config 
application for the Git version control program. Whether you use gii-config or not, it's a greiit 
example of wrapping a commantHine tool in a GUI that’s a little easier to use. 

This month’s Mac in die Shell presents some ver>" often-overlooked bash string operators. 
For diose that use the built-in operators, calls to external tools can be dropped, and 
performance can increase for everyone on tlie system. Check out how' in, ‘"bash String 
Operations.” 

In MacEnterpfise, Greg Neagle examines fhe viability of using the iPad as an Enterprise 
device. His analysis is in "‘iPad in tlie Enterprise.” Hi.s findings may corrobonite your day to day 
work as more and more Executives purchase iPads for their use. 

Jose Cmz this month also brings us a tutorial on how to reach BBEdit syntax-aware editing 
for different languages. Support Ibr C is built-in. What happens, though, when you need Python, 
Ruby or odier language support? 

Finally, this month’s MacTech Spodight highlights Boisy Pitre. Boisy is the owmer of Tee 
Boy, located in Opelou.sas, Louisiana, and quite an interesting person. Check out his approach 
to Mac devehjpment in this month’s MacTech Spodight. 

Ed Marezak, 

Executive Editor 
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Blame It on Rio 


I blame the Brazilians. 

I was shrugging off all this '‘Apple is turning into 
Microsoft hysteria until I got the call from Guilherme de 
Camargo Barros of Galilut Magazine and was forced to 
really think about the question, Guilherme wanted to 
interview me about Apple and 
Steve Jobs, and several of his 
questions were of the “has 
Apple become Microsoft?" 
variety, triggered by the report 
that Apple had passed 
Microsoft in market valuation. 

If'^passed” is the word I 'm 
seeking. Do you “pass" 
another car when you're 
heading north and you see it 
zip by in the southbound lane? But I digress. 

Being confronted with the question in an interview^ 
forced me to take it more seriously than I had been, Well, is 
Apple turning into Microsoft, or IBM. lor that matter, or 
some other relic of the past? Given some of Apple’s recent 
actions, it was a fair question. 

Only the more I thought about it^ the more sure I wa.s 
that it was really several questions. If Apple was in fact 
undergoing some ghastly transformation into a hideous 
monster out of the Technoznic, 1 realized that there were 
several candidate monsters, 

The Microsoft Meme 

Apple turning into Microsoft? 1 kinda get it. Remember 
"Td love to offer my app on the Mac but the Windows 
market is twenty times bigger and the incremental income 
wouldn’t justify the cost of porting”? Now put WebOS in 
place of the Mac and iPhone/iPad in place of Windows. OK. 


There must be some validity to the idea; it’s a topic 
(hHp:/fcitJy/J23xi3G) on Apple's own support discussion 
board. 

The premise seems to be that Apple's growth and its 
recent behavior in tromping on users and developers, as 
well as its de facto monopoly in some new market 

segments, are evidence that 
Apple is turning into Microsoft. 
But other conclusions could be 
drawn from the same evidence. 

Take the legal harassment 
stuff. That could be evidence 
that Steve Jobs is turning into 
Dari McBride, (Dari who, you 
ask? CEO of SCO, claimed 
ownership of Unix, built a 
business model on suing 
everybody, At least that's how I remember it, 1 could be 
wrong. Don't sue me, Dari). The de facto monopoly thing? 
Evidence that Apple is turning into Google. The whole 
police state kicking-down-doors thing? Apple is turning into 
Big Brother. Why wasn't 198^^ like 1984? So 2010 could be. 

Other Monsters 

I think you could make a stronger argument that Apple 
is turning into Sony. It’s hardly an original idea. Starting with 
dropping “Computer" from its najne, Apple has been pretty 
open about its movement into a posi-PC era of scads of 
different yet-to-be-invented consumer devices, and Steve 
jobs has always admired Sony. 

Or maybe Apple really is turning into Google. John 
Battelle says theyTe develcjping a search engine for apps. 
Why stop there? The iPhone OS is proof that Apple 
understands something that Microsoft never has: most users 
don’t bother to put their documents in nested folders, they 
just dump them in one folder or on the desktop and search 


If 1 were forced to say what it is that 
Apple is turning into, I’d have to say Its 
turning into Apple. A bigger, stronger, 
more Apple-like Apple. 
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for what they want. Google understands that search is a key 
operating system function; maybe Apple does, too. 

Tm unconvinced. I had dealings with Apple and Steve 
Jobs back in the 1980s, and I don’t remember this benign 
company that is implied by these laments over Apple 
turning into something different. If 1 were forced to say 
what it is that Apple is turning into, Td have to say it's 
turning into Apple. A bigger, stronger, more Apple-like 
Apple. It’s acting pretty much like it's always acted: 
arrogant, controlling, and bold. Only now, it has more 
power, 

And here’s one consequence of Apple’s embrace of 
posi-PC products that I’m not seeing mentioned in all these 
articles: you can no longer turn your Apple products into 
aquariums and hamster cages. Now that’s a shame. 


About The Author 
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GitConfig GUI 




by Jose R.C. Cruz 
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Introduction 

In today's article, we 
follow up on last montli's 
article, learning how to 
configure the Git tool to suit 
our revision control needs. We 
looked at die git-config 
command and its settings files. 
This month, we give the 
command a simple graphical 
interface using Xcode and 
AppleScript Studio. 

Readers are expected to 
know' their way around bash 
and AppleScript Studio. The 
Xccxle project feaaired here is 
available from the MacTech ftp 
site at f^^Jftpmaledi.aam. 


application icon 


main script 



Scripts 
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Giving Config a 
Face 

Like most Git commands, we need a shell session in order 
to use git-config. But diat does not mean we cannot wrap 
git-config with a simple graphical tool. This article shows 
one such tool built using Xcode and AppleScript Studio. The 
tool will access certain group of sellings and allow users make 
their changes easily. It will also alk^w users reverse their changes 
easily. 

For reasons of length, die tcxil handles only a small subset 
of git-config settings. Plus, it uses only the settings file from 
the project repository. Readers are w^elcome to download the 
Xcode project and extend it for their owm needs. Once again, 
die entire project is available from the MacTech ftp site at 
itp://ftp.mactechxom 

The project bundle 

Figure 1 shows the files of the demo projea, GitConfig. tt 
is based on the Xcode template AppleScript Application, which 
is available from die Project Assistant dialog. The template 


Figure 1. The GitConfig project 

already has the right files and settings needed to compile an 
AppleScript binary. The only files we need to attend are 
MainMenu*nib, GitConfig.applescript, and 
Info.plist. 

Listing 1 shows the contents of the Info.plist file, 
edited for brevity. Iliis file holds the metadata that describes the 
tool The key CFBundlelconFile points to the graphics file 
that has the tool icon. The key CFBundleldentif ier sets the 
tool’s unique ID. And die key CFBundleSignatiire sets the 
tool’s four-byte signature. 

Listing 1. The Info.plist fUe. 

<7Kml version="1.0'' fincoding=”UTF-8"?> 

(laOCTYPE pixst PUBLIC "-//Apple Computer//DTB PLIST 
1,0/ /EN" ■■ bttp: / /WWW. apple.com/DTDs/PropertyList-1 * 0. dtd" > 

<.plis.t_ver5ljon=’’I*.0"> _ 

<dict> 

<!— truncated for length.,* —> 

<key>CEBundlel coiiEile</key > 

<Btring)±con_6l7C.icnsC/string) 
<k6y>CFBimdleIdentlfier</key> 

<string>coin*mctech* anarakls. demo. git. conf ig</strln^> 
<key)CFBundlelnfoDic tiona ryVersion</key) 
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Figure 2. User interface of the GitConfig tool 


The third panel view, Colors, 
handles tliose settings that affect report 
colors. It uses three Check Box widgets 
to enable a color setting, as well as the 
underlying Box view. In each box view 
are tw^o Pop Up Button widgets—the 
left widget gives a list of available report 
slots, the right widget a list of available 
colors. 

As for the menu bar, only tlie File 
menu gets changed for the GitConfig 
tool. That menu gets tiiree menu items 
as showed in Figure 3- The Select 
Project... item starts an Open Folder 
session wherein users can select a 
project directory. The Save Settings 
item commits all changes back to the 
repository’s settings file. The Revert to 
Saved item discards those same 


a let 



Figure 3. The GitConfig File menu. 

<3t4:li]g>6m</string> 

<key>CFBundlePackageType</key> 

<Etring>APPL</string> 

<key>CFBundleShortVersionString</key> 

<striEg>l .0</strijig> 

<key>CFBundleSignature</key) 

<strir]g>617C<7strin3> 

<J“ truncated for length.,* -> 

</dict> 

<!/pllst) 

The user interface 

Figure 2 show^s tlie layout for the MainMenu. nib interlace 
file. A Ta]:jView widget divides the window into tlirce panel 
view^s, Clicking tiic tab label displays die panel associated to tliat 
label 

The first panel. User, has tliree Text Field wadgets. It 
handles tlKise settings that are u.ser-siiecific. It is also die default 
panel displayed by the GitConfig tool The second panel 
Project, handles the settings that control the project repository, 
On it are four Check Box and one Pop Up Button widgets. Tliree 
of the checkboxes enable a specific repositoiy^ action. One 
checkbox enables the popup widget, which gives a list of 
compression factors. 


changes and reloads the settings 
contained by the re^xjsitory file. 

The File menu also gives each menu item with a unique 
four-character signature. These signatures will help identify 
which menu item was selected liy the user. 

Loading the settings 

The GitConfig tool asks for the Icxation of die project 
repositoiy in two ways. It can ask for the location while being 
launched. Or it asks for the location after the user chooses 
Select Project*., from the File meniL listing 2 describes the 
code for the event handler will-finish-launching. The 
handler begins by setting four global variables to their initial 
values. Tlien it calls the chooseProject () routine and stores 
the returned path into the gPth gloi>al. If the path is valid, the 
handler calls three separate routines, each one loading a subset 
of settings. It passes the gPth global to each routine as input. 

Listing 2. Loading during launch. 

global gPth, gUsr, gPrj. gHue 

on will finish launching aiiApp 

— initialize Uie following globak 
set gPth to "" 

set gUsr to f) 
set gPrj to U 
Bet gHue to l| 

— ask the user for a project repository 
set gPth to chooseProject(} 

if CgPth is false) then 

display dialog ""This is not a Git-controlled 
directory" 
else 

-— rend tlie I'ollowing repo,sit{)ry seiLing.S 

— repos itc^ry:.setting.s: user 

•sat gUsr to loadGitUser from gPth - 

— repository:settings: project 

set gPrj to loadGitProj ECt from gPtb 

— repository ;settings:colors 

set gHue to loadGitColors from gPtb 
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QuarkX^: 



end if — (tPth is false) 
end will finish launching —anApp 

Listing 3 shows the code for the choose-menu-item 
handler. Tliis handler begins by identifying the source of die 
event. If the event came from a menu item, tlie handler checlcs 
the signature for that item. A signature of "slct' means the 
chosen menu item is Select Project.... Know^ing tills, die 
handler runs the chooseProject () routine to retrieve die 
new project directory. It updates die gPth global with the 
results and calls the same diree routines for loading the project 
settings. But tills time, the handler checks w^hich panel view is 
active on the GitConfig window. Once it identifies the panel, the 
handler runs tlie correct display routine for that panel 

Listing 3. Handling the Select Project... 
menu item. 

oji choose menu Item aMnu 

local tNomi, tTyp, tSet. tPth 
local tVal, tChg 

“ initialize the foJhwing kx:aU 

set tNom to name of aMnu as string 

set tTyp to class of aMnu as string 

— idt-ntily the a^Uin^^ widget 
if (tTyp is "menu item'') then 
— mciiuifik' 

if (tNom is "slct") then 

— fi I e' reptjfiittny; sell E ; select 

— ask the user for a project repositt^n^ 
set tPth to chooseProject0 

if (tPth is falae) then 

display dialog "This is not a. Git-controlled 

directory" 

else 

— update tlie fVdtow ing gJolial variable 


set gPth to tPth 

— read the follow'^ing repositoiy settings 

— repositoiy: settings:user 

set gUsr to loadGitUser from gPth 

— repository ;sening.s: project 

set gPr.J to loadGitProject from gPth 

-— repository: settings: colors 

set gHue to loadGitColors from gPth 

— identify the active panel 
if [£Pnl is "tUst") then 

— panel: settings :user 
showGitUser from gUsr 

else if (gPnl is "tPrJ”) then 

— panel: settings: project 
shovGitProject from gPrJ 

else if (gPnl is “tCol") then 

— panel: settings: colors 
showGitCoIors from gHne 

end if —(gPnl is "tUsr") 
end if —{tPih is false) 

— clear the window changed state 

set document edited of gWin to false 
else if {tNom Is "save") then 

— truncated for length 

else if [tNom is "rvrt") then 

— ...truncated for length 

end if — (iMotn is "slct") 

else If (tTyp is “'popup button'*) then 
— ...tiiincaled for lengih 

end if — (tTyp is "menu item") 
end choose menu item —aMnu 
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In Listing 4 is the routine choosePro ject(). This routine 
begins with the display of an Open Folder dialog using tlie 
choose-folder OSAX function. After a user chooses the 
desired project directory^ with the dialog, the routine checks if 
the directory has a liidden , git director}^ IF the check proves 
false, then the routine returns a FALSE, Otherwise, the routine 
convens the directory path into a POSIX string and returns the 
result. 

Listing 4. Choosing a project directory. 

to chooserroJectO 

— prompt for a project directory 

set tPth to choose folder 

with prompt text “Select a project directory” 

— check if die diiectory hiis a hidden igiC directory 

set tLst to list folder tPth 

if (tLst contains '\git") then 

— conven the path to POStX 

set tPth to POSIX path of tPth 

— return the cofiversion re'^ull 

return (tPth) 

else 

— retrieval h^ts failed 

return (falsej 

end if — (tLst (xjntains "►git") 
end chooseProject 

in Listing 5 is the first loading routine loadGitUser(). 
'liiis routine takes one input argument aPth, which holds the 
paih to die project repositors'. It starts with a record of null 
values. 4Len it calls the readConfig () routine, passing for 
input the repository path and the settings key, The 


readConfig() routine returns a string value, which 
loadGitUser () stores under the right record key. 

Listing 5. Reading the user settings. 

to loadGitUser from aPth 
local tGit, tVal 

— initialize the settings list 

set tGit to [uNom:"", uSig:”'’] 

— read the following user seiting^ 

eet tVal to raadConfig at aPth for "uaer.nainc” 
set uNom of tGit to tVal 

set tVal to readConfig at aPth for “user-email" 
set uEinl of tGit to tVal 

aet tVal to raadConfig at aPth for “user.signingkey” 
aet uSig of tGit to tVal 

— reaim the retrieval resuiis 
return (tGit) 

end loadGitUser — from aPth 

The code behind the readConfig() routine is shown in 
Listing 6, Here, the routine prepare,s the command statement 
needed to queiy a settings key. It then executes itie statement 
using the do-shell-script OSAX function. If no error 
txcLined, the routine gets a string value in return- Otherwise, it 
assumes an error string of 'n/a'. 

Listing 6. Reading a settings key. 

to readConfig at aPth for aKey 
local tCmd, tVal 
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— prepime the git-config statement 
set tCmd to "cd " £! aPth & “: ” 

set tCtod to tCmd & pGit & "-get " ^ aKey 

— execute the statement 
try 

set tVal to (do shell script tCmd) 
on error 

set tVal to “n/a” 
end try 

— return die key value 
return (tVal) 

end readConfig — at aPth for aKey 

Now the loadGitProject() routine shares the s^mie 
code structure £ts loadGitUser^ ). The loadGitColors () 
routine (Listing 7), however^ is a bit more complex due to the 
data it handles. First, the routine prepares two local records, The 
local tGit holds the color settings for three report types and the 
local tSet holds the color settings for each type. The routine 
then calls the reddConfig{) function, passing along the 
settings key for a given report. It then writes the returned color 
state into the tGit local. Next, the routine calls the function 
readColorSlots(). To that function, it passes the repository’ 
path, the repon type and a record of slots, lliis function returns 
a list of color settings^ which loadGitProject() then stores 
into tlie tSet loc:al. Finally, it appends a copy of tSet to the 
tGit local. The routine repeats the same sequence of steps for 
the remaining types. 


Listing 7. Reading a color setting. 

to loadGitColors froin aPth 

local tGit, tSet, tSlt. tVal 

— inirialize the following locals 

set tGit to Idiff:false, twig:false, star:false! 
set tSet to [enbl:false, slot:!!, colr:[)J 

— read the following seEtings 

— color:git-branch 

set tSlt to ("current"*, "local", "remote", "plain"! 

set tVal to readConfig at aPth for "color.branch" 
if (tVal = "n/a") then 

set enbl of tSet to false 

else 

set enhl of tSet to tVal aa boolean 
end if —(tVal = "n/a") 

set tVai to readColorSlots 

from aPth for "branch" given slot;tSlt 
set slot of tSet to tSlt 
set coir of tSet to tVal 
copy tSet to twig of tGit 

— color; git-diff 

— ...truncated for length 

— color: git-status 

— ...truncated for length 

— return tlie retrieval restilts 
return (tGit] 

end loadGitColors — fromaPth 

Listing B shows the code behind the readGolorSlots( ) 
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routine. This routine begins with its tLst local set to an erapt>^ 
list. It then parses each entry of its aSlt input and passes the 
result, a slot naniej to the readColorValue() function. That 
function takes the slot name and adds it to the git-config 
statement. It submits the statement to readConfig() and gets 
a color value in return. If it gets an 'n/a' result, 
readColorValueO returns a default color value of 
'normal', Whatever color value is returned, 
readColorSlots(} adds the value to the end of its tLst 
local This ensures that each color value is in the same position 
as the slot. 

Listing 8. Reading the colors of each 
report slot. 

to readColorSlotfi from aPth for aGmd given aiot:a31t 
local tSlt, tLstf tGitt tHue 

— the Following locals 
set tLst to U 

— .start pai>iing the color slots 
repeat with tSlt in aSlt 

set tHue to (readColorValue from aPth ^ 
given command: aCtnd, slotitSlt) 
copy tHue to the end of tLst 
end repeat — withtSIlinaSlt 

— ret LI I n I lie retrieval results 
return (tLst) 

end readColorSlots — from a Pth for aCmd given slotaSlt 

to readColorValue from aPth given command:aCmd» alotiaSlt 
local tHue> tGit 

— prepare the Git suliconiinand 
set tdit to ^colot,” ^ aCmd 
set tGit to tGlt & it aSit 

— read the ailor setting 

set tHue to readConfig at aPth for tGit 
if (tHue = "n/a"] then 
set tHue to '"notmar' 
end if — {tHue ="n/a") 

— return the color value 
return (tHue) 

end readColorValue — (rum aPth given oirnmand^aCmd, slotaSlt 


Displaying the settings 

In order For GitQjnhg lo display its lists of settings, it needs 
to know which widget gets wiiich setting. This means each 
panel widget on the GitConfig window must have a uniciue 
name. Consider the User panel example (Figure 4). Each 
text field widget gets a four-character name. To assign a name, 
open the MainMenu.nib bundle with Interface Builder. Select 
a widget and choose AppleScript Inspector from the Tools 
menu. Then in the Name field of the ensuing inspector palette, 
type the name for that widget. Repeat the same steps for all 
relevant wddgets. 



uEml 


usig 


Figure 4. Naming the interface widgets. 


Displaying each set of Git settings presents other 
challenges. Fiist, not all widgets on each lab pane! view are 
available after launch. If a panel is inactive after launch, the 
window dim not load its widgets from the nih bundle. Thus, any 
references to that panel's wddgets will point to a null object 
Second, switching from one tab panel to another does cause the 
w indow^ to load the wddgets that panel needs to display. On the 
other hand, that same window could off-load the widgets from 
the last active panel to save resources, This again results in that 
panefs widget references to point to null objects. 

To detect w^hen each widget becomes available, GitConfig 
relies on its awake-from-nib handler (Listing 9). Above the 
handler are six sets of glohrti variables—they hold the references 
to each loaded widget. The handler stans l>y reading the class 
anti name of the target widget. It then uses this information to 
store the widget to the correct global, Note die same handler 
also detects and stores a reference to the main window itself. 

Listing 9. Detecting the widgets. 

global gWin 

global uHom, uEnil, uSig 

global rLnk. rEOL, rSlp, 2ipL, rCln 

global dCHk, dSlt, dCol 

global bChk, bSlt, bCol 

global sChk, sSlt, sCol 

on awake from nib anObj 
— icluntify ihu ctintruf 
set tTyp to class of anObJ ai string 
set tNom to name of anObj as string 

if (tTyp is ''tab view item'') then 

— view:pandrt;ib 
— He:SER\TD 

elae if (tTyp is "text field") then 

— cnntrobhftdat^xt 
try 

if [tWonii is “^om") then 

“ ton!n) I: n u ld:lt?xt: U St?r:: numt* 
set uNom to anObj 
else if (tNom is “uEm!'') then 

— control Held: text: user:e-nia il 
set uEml to anOhj 

else if (tNom is "uSig") then _ 

— controlficld: text: u ser :sij^h:itu re 
set uSig to anObj 

end if —(tNom is "uNom") 
on error eMsg 

log C'lGUConfigiawake-rroni-nih:'' 8c eMsg) 
end try 
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else if (tTyp is ''popup button") then 

— c:oncrol:button:pop-iip 
if (tWom is " 2 ipL") then 

— control :buttorL: pop-up ^compression: level 
set aipL to anObj 

else if {tNom is "dSlt") then 

— ... truncated for length 
end if — {tNom is *'iiJS]om") 

else If (tTyp is "button") then 

— control; bii non: check-i^jox 
if (tNom is "rLnk'') then 

— control; b utton :chec k-box; sy mlink: follow 
set rLnk to anObj 

else if [tHon is "rEOL") then 

—conn-ol; bn tton :check-box; end-of-line :POSIX 
set rEOL to anObj 
else if (tNom is "rZip") then 

— control: bn tton rcheck-box Lcompiession: enable 
set rZip to anObj 

else if (tNotn is "rCln") then 

— Cfjntroi ;bn tto n: c lieck-box :clea n; explicit 
set rCln to anObj 
else if (tNom is "dChk") then 

— ... tiuncaied for length 
end if — (iNom is "uNom") 

else if (tTyp is "window") then 

— view; window 

if (tNom Is "617C") then 
set gWin to anQbj 
end if — (tNom is''617C") 
end if — (iTyp is ''tab view item") 
end awake from nib -anCDbj 



xfDcDeveIdjfers 

BbjecrR^ational Everywhere 

\ \ ._ I 


legendary Speed X100 * / ^ 

Corumnar Format 

»» pa 

Enayphon 

SSI Cemiiresskn Tables + Links 

Boi>jouf/z«oxon(ig Direct Pointers 

ouar, * ^ Navigation API 

PHP Data Objecti ^ 


Tables, Keys by Values 
PK, FK, Views, Triggers 
SQL, Stored Procedures 
Local & Client/server 


© Reports ©Server ©Studio ©AOKs 


PI atfo rms: Windows, Linuic Mac OS X, i Phone 

Connectivity: Dfrector, REALbasic. Revolution, C, C-»-+, C#, Qb|-C, 

COM, VB6, VB.NET, PHP, Ruby, ODBC 
Li te nse: Roy a Ity free for both local a nd cl lent/server* 


For the awake-from-nib handler to do its job, it must tie 
attached to each widget on the GitConlig window. This too is 
easily done in Interface Builder. Select again each widget and 
choose AppleScript Inspector iTom the Tools menu. From the 
Scope pop-up menu, choose the menu item Global From the 
Script pop-up, choose GitConfig-applescript. Then from 
the Event Handlers list, set the checkbox next to the awake- 
from-nib event. Save your changes when done. 

Now' the actual display is handled by ihree separate 
routines, one fur each group of settings. Each routine gets one 
input argument, aCfg, wiiich is the record object holding the 
settings. The showGitUser() routine (Listing 10) handles the 
user settings. This one simply writes the settings to the correct 
wadget on the User panel. The showGitPro ject () routine 
handles the repositoiy settings. It too writes the .settings to the 
widgets on the Repository panel, l^ui in the case of 
core.compresion, the routine sets and enables the rZip 
outlet if the compression level is greater than zero. Tlien it 
displays the level on the zipL outlet. 

Listing 10. Displaying the user and 
repository settings, 

to shawGitUser fxom aCfg _ 

try 

set content of uNom to uNom of aCfg 

set content of uEml to uEtnl of aCfg 

set content of uSig to uSig of aCfg 

on error eMsg 

log [" [GitConf ig] EhovGittfset: " & eHsg) 
end try 


www.valentma-db.conn 


WVm, MACTEOH.COM 





















Rediscover your computer fleet 
with Absolute Software. 


Increase auditing accuracy 
Lower compliance risks 
Minimize security risks 
Reduce total cost of ownership 


Find and manage your Mac and PC computers with Absolute® 
Software. From the largest corporations to your home office, our 
Computrace®, Absolute Manage and Lojack® for Laptops solutions 
help you improve data protection, simplify computer lifecycle 
management and recover stolen computers. 

For a FREE demo of Absolute Manage visit: 

www.absolute.com/rediscover 



Absolute^S oft ware 

The absolute best way to track, manage & protect your digital world. 






end ehovGltUser —fromaOg 

to showGltProJect froni aCfg 
local t¥al» tFlg 

try 

set state of rLnk to (rLnk of aCfg as boolean) 

set state of rEOL to frEOL of aCfg as boolean) 

set state of rCln to (rCln of aCfg as boolean) 

set tFlg to (rZip of aCfg as boolean) 

if (tFlg) then 

aet tVal to eiph of aCfg as string 
if (tVal is “9”) then 

set tVal to tVal & "" (highest)'' 
end if — (tValis'T) 

else 

set tVal to “0 (none)" 
end if — (tHg) 

set state of rZip to tFlg 
set enabled of zipL to tFlg 
set title of zipL to tVal 

on error eMsg 

log {" [GitConfig] showGitProJecti” & eMsg) 
end try 

end showGitProject —fromaCfg 

Not surprisingly, the showGitColors ( ) (Listing 11) routine 
takes extra steps to ensure each report slot is mapped to the 
right color. It starts by reading the repon s color settings from the 
aCf g argument. Then it displays that report's color state stored 
under the enbl record key. Next, it reads the displayed slot 
name from the outlet linked to the pop-up menu widget (showm 
here as dSlt). The routine then calls tlie getSiotColor () 
function, passing as input the slot name and the color settings. 
This function returns the color value fcir the given slot. Then 
showGitColors () displays the returned color on the second 
outlet (here licking dCol). The routine follows the same series of 
steps for the oilier tv^'o Git reports. 

Listing 11* Displaying the color settings* 

to showGitColors from aCfg 

local tSet. tFlg, tSlt, tHue 

— display ilif fotlowing t’ok>r serrinH-s 

— panel ;setting.s:cobrs:difr 
set tSst to diff of aCfg 

set tFlg to (enbl of tSet as hoolean) 
set state of dChk to tFlg 
set enabled of dSlt to tFlg 
set enabled of dCol to tFlg 

set tSlt to title of dSlt 

set tHue to getSlotColor for tSit from tSet 

set title of dCol to (tHue as string) 

— panel :settings :color5 :bra nch 

— ...truncated for length 

— panel:settingsx:c.>lors:statirs 

— ...truncated for length 
end showGitColors — frtJtnaCfg 

to getSiotColor for aSlt from aSet 
local tHue. tLat, tSlt 
local tidx. then 


set tHue to "normal" 

try 

— locale die slot index 

set tLst to slot of aSet 
set tLen to length of tLst 
repeat with tidx from 1 to tLen 
set tSlt to item tldx of tLst 
if (tSlt is aSlt) then 
exit repeat 
end if —(tSItis aSlt) 
end repeat — with tidx from 1 to tLen 

— read the color vaiue 

set tLst to colt of aSet 
set tHue to item tidx of tLst 
on error eMsg 
— RESERVED 
end try 

“ return die color ^>etting 

return (tHue) 

end getSlotColor —for aSlt from, aSet 

'fhe GitConfig tool invokes each display routine at dilTerent 
points of its process cycle. Ftir instance, it invokes only the 
showGitUser () routine after it displays its main window 
(Listing 12). Tliis is because the window lias the User tab panel 
as its default panel view^ Wlien users .switches to a different 
panel view, GitConfig uses the selected-tab-view-item 
handler to invoke the di.splay njuline for that panel. Notice how 
belli handlers keep track of the active panel view with the gPnl 
global 

Listing 12- Invoking a display routine- 

global gPni 

on launched snApp 

— display the user settings 
set gPnl to "ttlEr’' 
showGitlJser from gtJsr 

end launched —anApp 

on selected tab view Item aTab tab view item aPnl 

— identiFy the active panel 
set gPnl to name of aPnl 
if {gPnl is "tlJsr") then 

— paneh.setling^iruser 
showGitUser from gUsr 

else if (gPiil is “tPrjf"] then 

— pa riel : settings: pro|ect 
showGitProject from gPrjf 

else if CgPnl is "tCol") then 

— panel: settings; colors 
showGitColors from gHue 

end if — (gPnl is "tUsr") 

end selected tab view item —aTah tab view itcrn aPnl 

As for the Colors panel, GitConfig uses the choose-inenu- 
item handler (Listing 13) to detect which re|xirt slot is selected 
by the user. Here it checks if the calling object is a pop-up 
liutton widget. Then it checks that widget's unique name. Next, 
it reads the chosen slot name. It passes that name, togedier widi 
the correct color record, to die gets lotCo lor () function to 
retrieve the color value. And then it p^isses the color value to die 
second pop-up button widget for display. 


— set die deihull color setting 
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Listing 13. Displaying a color value. 

on choose menu item aMnu 

local tNom, tTyp, tSet, tPth 
local tVal, tChg 

— inirialize the following locals 

set tNom to name of aMnu as stting 
set tTyp to class of aMnu as string 

— identify the calling widget 

if (tTyp is ‘“.menu item") then 
“ menujfile 

“ ...truncated for lengtli 

else If (tTyp is "popup button") then 

— menu:pop“Up 
set tChg to true 

“ identify the popup button widget 
if [ttiom is "zipL") then 

— menu: pop-up; compress ion level 

— ...truncated for lengtli 

else if (tNora is "dSlt") then 
—^ menu: pop-up idiff: slot 

— load the slot color setting 
set tNom to title of dSlt 
set tSet to diff of gHue 

set tNom to getSlotColor for tNom from tSet 
set title of dCol to (tNom as string) 

else if (tNom is “dCol") then 

— menu; pop-up; diff: color 

— ...truncated for length 

else if (tNom is “bSlt“) then 

— menu: ix)p-up: bra nch:.slQi 

— load ihe ^slot color setting 
set tNom to title of bSlt 
set tSet to tvig of gHue 

set tNom to getSlotColor for tNom from tSet 
set title of bCol to (tNom as string) 

else if (tWom is *'bCol") then 

— menu rpop- u p: hra nc 1 1 ctslor 

— ...truncated for length 

else if (tNom is "sSlt") then 
—‘ menu:pop-up:5mms;slot 

— load the slot color .'setting 
set tNom to title of sSlt 
set tSet to stat of gHue 

set tNom to getSlotColor for tNom from tSet 
set title of sCol to [tNom as string) 

else if (tNom is "sGol") then 

— menu; pop-U p ^.status; color 

— ...truncated for length 
end if —(tNom is "zipL'’') 

— set the window changed state 

set document edited of gWin to tChg 
end if — (tT^p is "menu item") 
end choose menu item —aMnu 

Updating the settings 

Now when users change one or more settings on each 
GitConfig panel, GitConfig writes the changes back to its global 
buffers, but not to the settings file. Ttiis preserves tlie original 
senings still in tlie files and allows users to reverse their changes. 


How GitConfig handles the changes depends on the widget that 
held the change. If the widget is a text field widget, GitConfig 
uses the changed handler (Listing 14), This handler reads the 
content and unique name of the widget. Then it writes the 
content to the correct record item in the gUsr global. 

Listing 14. Handling the text field widget. 

on changed anObj 

local tVal, tNom 

— initialize tlie following locals 
set tNom to name of anObj 
set tVal to content of auOhJ 

— identify the calling widget 
if (tNom is “*uNcim") then 

set uNom of gUsr to tVal 
else if (tNom Is "uEml") then 
set uEml of gtlsr to tVal 
else if (tNom Is "uSig'*) then 
set uSig of gUsr to tVal 
end if — {tNom is 

— set the wdndow changed state 

set document edited of gWin to true 
end changed —anObj 

If the changed widget is a checkbox button, GitConfig uses 
the clicked handlei- to deal with the change (Listing 15). This 
handler also begins by reading the name and state of the widget. 
Based on the name, it stores the retrieved .state into the record 
entry of the correct global. But for the widget named rZip, the 
handler displays the latest compression level for the repository. 

Listing 15. Handling the checkbox button. 

on clicked anObj 

local tNomI tFlg 

— initialize the following local.'^ 
set tNom to name of anObj 

set tFlg to state of anOhj aa boolean 

— identily the calling w idget 
if (tNom is "rLnk") then 

— set ting: flag: project: link 
set rLnk of gPrj to tFlg 

else if (tNom is ”r£0L”) then 

— setti ng: n ag: praject: end-c >f-line 
set rEOL of gPrj to tFlg 

else if (tNom is "rZip") then 
“ netting: fl ag: pmiect :compression 
set enabled of zipL to tFlg 
if (tFlg) then 

set tNom to zipL of gPrJ as string 
if (tNom is "9") then 

set tNom to tNom ^ " (highest)" 
else if (tNom is "0") then 

set tNom to tNom k " (none)" 
end if —(tNomis"9''') 

set title of zipL to tNom 
else 

set title of zipL to “0 (none)" 
set zipL Of gPrj to 0 
end if —(tFlg) 
set rZip of gPrj to tFlg 

else If (tNom is "rCln") then 

— setting :fkg: project: dean :explicit 
set rCln of gPrj to tFlg 
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else if (tNom is "dChk") then 

— setting :flag:color;d[ff 

set enabled of dSlt to tFlg 
set enabled of dCol to trig 
set enbl of diff of gHue to tFlg 

else if [tNom is ”bChk”) then 

— setting;flag:a)lor^branch 

set enabled of bSlt to tFlg 
set enabled of bCol to tFlg 
set enbl of twig of gHue to tFlg 

else if EtNoui is ‘‘sChk") then 

— iiettingiflagx’olor: status 

set enabled of sSlt tO tFlg 
set enabled of sGol to tFlg 
set enbl of stat of gHue to tFlg 

end if — (tNom is "rbik") 

— sei ilie windciw changed state 

set dpcument edited of gWin to true 
end clicked —anObj 

Supposed the changed widget is a pop-up button? In ihLs 
case, GitConfig handles the change via its choose-menu- 
item handler (Listing 16). This is the same hajidler that 
processes the File menu selections. It is also tlie same handier 
that displays the color values for each report slot. 

Listing l6. Handling a pop-up menu. 

on chooae menu item aMnu 

local tKom. tTyp. tSet* tPtb 
local tVal, tChg 

— initialize ihe following locals 

set tNoffi to name of aMnu as string 
' set tTyp to class of aMnu as string 

— identify the tailing widget 

if (tTyp is '‘Tiienu item") then 

— menu: file 

— ...tninaited for length 

else if (tTyp is “popup button“) then 

— menu up 
set tChg to true 

— identily the popup button widget 
if (tNom Is '^zipL''} then 

— menu:pop-up:a>nipressk>riJevel 
set tVal to title of aMnu 

set tVal to character 1 of tVal 
set aipL of gPrj to tVal as integer 

log gPrj 

else if {tNom is "dSlt'*) then 

— menu: pop-up: diff; slot 

— ...tumcaied for Icngtli 

else if (tNoaj is “dCol**) then 

— menu:pop-up:diff:CGlor 

— read the color setting 
set tNora to title of dCol 
set tTyp to title of dSlt 

— update the settings tniffer 
set tSet to diff of gHue 

set tSet to (setSlotColor on tSet for tTyp into 

tNom} 

set diff of gHue to tSet 

else if EtNom is “bSlt"*] then 

— menu: pop-up; branchuslot 
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— .^.Lruncaced for length 

else if CtNom is "bCol''} then 

— menu; pop-up: branch: color 

— read the color setting 

set tNom to title of hCol 
set tTyp to title of bSlt 

— update the settings buffer 
set tSet to twig of gHue 

set tSet to (setSlotCalor on tSet for tTyp Into 

tNom) 

set twig of gHue to tSet 

else if CtHom is “sSlt’*) then 

— menu :pop-up; status: slot 

— ...truncated for length 

else if (tNccm is "sCol”) then 

— menuipop-upistarusicolor 

— read tlte color -setting 

set tNoti] to title of sCol 
set tTyp to title of sSlt 

— update the settings buffer 
set tSet to stat of gHue 

set tSet to {setSlotCalor on tSet for tTyp into 

tNam) 

set stat of gHue to tSet 
end If — (tNom is "zipl") 

— set the window changed state 
set document edited of gWin to tChg 
end if — (iTyp is ''menu item") 
end choose menu item —aMnu 

As before, the handler reads the name and type of the affected 


widget- If the widget is a menu item, the handler runs the code 
as described in Listings 4, 19 and 22. But if the widget is a pop¬ 
up button and one that displays a list of report slots, the handler 
runs the code in Listing 12. Now if the widget is one that displays 
a list of color values, the handler reads the report slot that 
corresponds to that color value. Next, it reads the chosen color 
value. Finally, the handler calls the setSlotColor() routine 
(Listing 17), passing for input the slot and color, as well as the 
record entry for the given report. Tlie routine then returns the 
modified record, which the handier stores into the gHue global. 

Listing 17* Setting the color value. 

to sotSlotColor on aSet for aSlt into aHue 
local tHue, tSlt. tLat. tMod 
local tidx. tLen 

— initialize the following local 
copy aSet to tffod 

try 

— locate the -slot index 
set tLst to slot of tMod 
set tLen to length of tlst 
repeat with tIdx from 1 to then 
set tSlt to item tidx of tLst 
if (tSit ±3 aSlt) then 
— update the slot ctilor 
set tLst to coir of tMod 
set item tidx of that to aHue 
set coir of tMod to tLst 
end if —{61tisaSlt) 
end repeat — with tidx from 1 to tLen 
on error 
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end try 

— return the modified settings 
return (tMod) 

end setSiotCalor —on aSet for aSlt into aHue 

Committing the settings 

Now when users choose Save Settings from the File menu, 
GitConfig reacts by invoking its choose-menu-item liandler 
(Listing 18), This handler runs three save routines when the 
menu item’s signature is 'save'. 

Listing 18. Handling the Save Settings 
menu item. 

on choose m&nu item aMnn 

local tNom, tTyp. tSot. tPth 
local tVal, tChg 

— iniiialis^e tlie following locals 

net tNom to name of aMnu as string 
set tTyp to class of aMnn as string 

— identify tlie calling widget 

if {tTyp is "menu item") then 
— menudile 

if {tNom is "slct") then 

— file: repository ‘settings :.select 

— truncated for length 

else if (tNom is "save") then 

— file! rcpcjsitory :settings:sa ve 

— save the Following settings 

— repository: senings; user 
saveGitUser from gUsr 


— repository: settings: project 
saveGitProject from gPrj 

— repository:settings colors 
saveGitCalors from gHne 

— clear die window clianged state 

set document edited of gWin to false 
else if (tNom is "rvrt") then 

— file: repository; settings :re\ert 

— ...truncated for length 

else if (tTyp is "popup button") then 

— irLenu:^p-up 

— ...truncated for lengtli 

end if —{tTy’p is "menu item") 
end choose menu item —aMnu 

The first save routine saveGitUser( ) (Listing 19) writes 
the settings held in the gUsr global. It reads each entry from 
gUsr and passes them to the writeConfig() routine. It also 
passes die settings key and the location of the settings file. Tlie 
writeConf ig{) routine uses the supplied key value and path 
to prepare the git-con fig statement. It then executes the 
statement with the 05AX function do-shell-script. 

Listing 19 . Committing the user settings. 

to saveGitUset from aCfg 
local tVal 

— save the ftillowing scriiingsS 

— sortings: user: name 

set tVal to uNom of aCfg 
set tVal to fit tVal fit 
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writeConfig for “user.name" at gPth into tVal 

— settingsuiser:e-mail 

set tVal to uEml of aCfg 

set tVal to . & tVal S "'“ 

writeConfig for '^user.emaiP at gPth into tVal 

■— ^ttings: user'signature 
set tVal to uSig of aCfg 
set tVal to '■ ■ “ ^ tVal ^ “ 

vriteConfig for “user,aigningkey” at gPth into tVal 
end saveGitUser —from aCfg 

to vriteConfig for aKey at aPtb into aVal 
local tCmd, tErr 

— prepare the git-conrig statement 
set tCmd to “cd “ i aPth Hl 

set tCtnd to tCind & pGit & aKey 4 “ " & aVal 

— execute the statement 
try 

set tErr to [do shell script tCmd} 
on error eMsg 

set tErr to eMsg 
end try 

end wr i t e C on f i g — for a Key a t aPth into a Val 

The second saw routine saveGitProject () has the 
same code structure as saveGitUser( ). But the 
savedtColors() routine (Listing 20) uses a more complex 
structure to ensure each lepon slot is mapfied to die right color. 
This routine begins by preparing tiie settings key lor a given 
repon. It then checks the color state lor that mporl. 11 colors ai^^ 
enabled, the routine reads the skits and color entries, and then 


passes them to the writeConfig() routine. Afterwards, it 
passes the color state to the same writeConfig() routine. 

Listing 20. Committing the report colors. 

to saveGitColors from aCfg 

local tFlg. tSlt, tHue, tGit 
local tSet* that 
local tldx, tMax 

— .save the following settings 

— settings: project:color; branch 
set tGit to "color.branch” 
set tSet to twig of aCfg 
set tFlg to enbl of tSet 
if (tFlg) then 

— settings: p roject; color: branch: slots 
set tLst to slot of tSet 
set tMax to count of tLst 

repeat with tidx from 1 to tMax 

set tSlt to item tIdx of slot of tSet 

set tSlt to tGit fit ",” fii tSlt 

set tHue to item tidx of coir of tSet 

writeConfig for tSlt at gPth into tHue 
end repeat —with tidx from 1 to tMax 
end if —{tFlg) 
set tFlg to tFlg as string 
wrlteConflg for tGit at gPth into tFlg 

— sell \ ngs: p ff iject:co It >r:t.l j fj 

— -.truncaied for lenglli 

— Sftl ingS: p n iteci :ct ilt jr:st a t us 

— ...truncaiecl for tt^ngih 
end saVeGitC 0 1 0 rs — from aCfg 
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Suppose the user choose Revert to Save from the File 
menu? In case, GitConfig runs another part of its choose- 
menu-item handler (Listing 21), This part runs only when the 
menu item has a signature of ' rvrt'. It calls the same three 
load routines and stores their results into the appropriate global 
variable. Next, it checks the active panel view' on the GitConfig 
window. It then calls die correa display routine for that panel. 

Listing 21, Reversing the changes, 

on choose menu item sMnu 

local tHoro, tTyp, tSet, tPth 
local tVal. tChg 

— the following locals 

set tNom to name of aMnu as string 
set tTyp to class □£ aMnu as string 

- identify the calling widget 
if (tTyp is ■'raenu item”) then 

— menudllt^ 

if (tNoni is '"slct") then 

— fi le: rep( >sitor>' :settings :,select 

— ...truncated for length 

else if (tNom is “save”) then 

— file: reposito ry :.se ve 

— ..truncuted for length 

else if (tMotii is “rvrt”) then 

— file: repository :,settings: reven 

— rend the tbllowing settings 

— rejmsi tor}'^settings: user 

set gUsr to loadGitUser from gPth 
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— repository: setting's rpTOject 

set gPrJ to loadGitProject from gPth 

— repositoiy: settings ^colors 

set gHue to loadGit Colors from gPtb 

— identify the active panel 
If (gPnl is “tUsr”) then 

— panel rsettings: user 
showGitUSer from gUsr 

else if (gPnl Is "tPrj"'') then 

— panel ^settings: project 
showGitProject from gPrj 

else if [gPnl is “tCol^'l then 

— panel ^settings: colors 
showGitColors from gHue 

end if - (gPnl is ”tUar”) 

— clear the window changed state 
set dtK:Liment edited of gWin to false 

end if — (tNom is'"sld'') 

else if (tTyp is “popup button”) then 

— menu: pop-up 

— ...truncated for length 

end if — (tTyp is "menu Uem'O 
end choose menu item —aMnu 

Summing Up 

The git"Gonf ig command gives us the means to prepare 
and configure our Git setup. In this article, we managed to w'rap 
the command in a simple graphical tool. Our tool is built with 
the aid of Xcode and AppleScript Studio. It lets us select which 
project repository^ to configure, li can load the most often used 
settings and save any changes made to those settings, Plus, it can 
reverse those same changes. 

And that ends today's study AppleScript, Xcode and the 
open-source Git tool. But .stay tuned to this spot as we learn 
more about Git and its capabilities. Lintil then, I bid you good 
day. 
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Mac in mE Sheu 


by Edward Marczak 

bash String 
Operations 

i jOr, doing more with less ^ 

Welcome 

At the end of last month's column I promised more bash tips 
and ticks this month. Tliat’s riglit: ticks. If 1 can have the latitiide to 
define 'ticks' as, “a little used .shall convention due to the nervous 
tick it induces,” I tliink 1 can make that typo work retroactively. 'Hie 
bash shell has support for some of the same siring operations tliai 
other languages do, without tlie need to ciiU some non-native shell 
routine. This montli, Til introdtice basifs .siring operators and 
examples of how to use tliem. 

Variable Review 

IVe covered this in the past, hut it's worth n review. Variable 
names consist of letters, digits and undersct^re characters. On 
assignment, ju.st the variable name is needed; 

greeTing=''Hello, ** 

When referencing a variable, it is preceded with the dollar-sign 
character to denote it as a variable to lx? tokenized for substitution; 

echo Snaute" 

However, ratlier than just a dollar-sign and the name, there’s 
a more specific way to specify variables: enclosing them in CT.irly- 
brackets. Get into the habit of enclosing ail variables in curly 
brackets: 

echo i greeting J > 

This will save you headache, believe me. Why? First, you may 
need to assemble a file name like tliis: 


Wrong: echo $11 

Witliout the cmrly brackets, tlie shell takes the shorter route and 
just uses $1. So, if the first positional parameter to a script w^ere 
entered as “ralph” $10, $11 and $12 would be: 

talphO. ralphl. ralph2 

Use the cudy-hracket form to get the correct values. 

Lastly, you'll need to use the curiy brackets for anytliirig used 
in the remainder of this article. Now, onto the article. 

Operator, Operator! 

Many development languages have stntightforward ways of 
manipulating strings. M<xst people that use bash end up calling 
external programs to do this work. Wliile tliat’s sometimes 
appropriate, or even necessary, one can handle most chores with 
l^ash itself, hash has several built-in string operators, and I rarely 
see them used. 

Each of tlie operations uses the cudy-brace syntax. They 
work by adding special characters tliat are interpreted as 
operators. 

Substitution Operators 

The first group of operators ctllcms for substitution of the 
supplied vanable. 

$ {variable :^sub} —Substitute if vanable Ls null, 

$ {variable :“sub} — Assign is variable is null. 

$ {variable: ?message} — Abort if null. 

$ {variable ;+sub} — If variable is defined, return tlie 
substitution, otheiwise, return null, 

${variable: start:length} — Return a substring of 
5variable, .starting at start, for a lengtli of length. 

In each case, if the variable is null or not defined, a substitution 
takes place. Take this command substitution as an example: 

thelist=$tls ""Slsoraedirl") 

After executing tlds Line, die variable $tlieiist will contain the 
output of the Is command for svhatever $somedir is pointing to. 
However, if the directoiy that Isomedir represents is empty, tlien 
$dielist will be null. Assuming dial Is $soinedir is null, then: 


filen $ us e r_$ d at e.t Kt 

In tfiis case, the shell will to concatenate ’'$user_” and ' $date”. 
Note die miiJing undersmre on "$userj’ and you’ll see why diis 
will always lie empt>'. This should rewritten as: 

f lleiiajii:e==$ i userU$} date). txt 

Secondly, you’d need to use curly bracket variable syntax to 
reference any positional parameter variable greater than 9: 

Right: echo ${12} 


echo ${thelist:-Empty] 

will output “empty”. Tlie v^iriahle Sdielist remains unmodified. Still 
assuming die $tlieiist Ls null, this SLib,stityiion: 

echo ${thEliEt:^it[pty] 

will not only print “empty”, l)Ut it will also assort the .string 
“empty” (or whatever we supplied) to $thelisi. A subsequent 
"echo ${thelist}” will now also print “empty”, 
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Tlie two substitutions shown make the substitution and let the 
script move along. Tlie tiiird version w^ilJ exit after printing its 
message: 

echo ${thelist:7"The List is empty”! 

will print \/scriptnaine: line x: thelist: The list 
is empty’'. 

To l^e clear, \ook at the short script in Listing 1, 

Listing 1: test_scnpLsb 

ih /hin/bash 

echo $! thelist: 7"The list Is empty''] 
echo *This is the last line. ” 

This code will output “./test_script.sh: line 3: thelist: Tlie list is 
empty'' and the exit. The final line will never l>e executed. This is 
one way to ensure that an undefined variable doesn’t cause havoc 
in a script. 

The next one takes a little getting used to. ITie bash string 
operator performs a test. If the variable is defined, return the 
substitution. If it is not defined (null), return null, "fliis could easily 
be used to denote a Boolean. For example, if you just want to 
mark tliat an option is set, you could use tlie following code to set 
$debug to 1 if SdebugFlag is not null: 

ciebua=$ I debugFla^t +i I 


Possii^ly tlie most common string operation is to extract a 
substring from a given string. You can use many tools external to 
bash to do this: cut, sed and awk immediately jump to mind. 
However, for simple substring needs, Ixtsh lias a siring operator for 
this built in. If Svarialile contains "^The striped egg” tliert the 
following bash operation: 

adj=$iyariahle;4:7 I 

will assign "striped” to Sadj. If the length is omitted, the substring 
runs from the start until the end of the string. Using the same string 
for $variable, this operation: 

adj=$[variable:41 

would assign “striped egg" to $adj. Interestingly, the colon operator 
has special interaction with (the special variable containing all 
positional pammters). Instead of charaaer positions in a string, the 
operator knows to act on each individual element. For example, 
look at die shon bash script in Listing 2. 

Listing 2: optesLsh 

#!/bin/bash 
echo $t@:3i 

Running it witli the following arguments yields the output shown. 

$ ,/opteat.sh alfred bruce Charles david 
Charles david 

Bear in mind diat Im not .suggesting you banish cuL sed and 
awh from your bash scripting. There are cases where they are 
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needed. Just don't overlook the substring function that's available 
witliin bash, tliat's ail. 

Pattern Matching 

Typically, when looking to perfonn pattern matching on 
strings, hash users will call external utilities. However, hash has 
several pattern matdiing operators built in. Here's a list: 

${variable#patterii} — Delete shortest match from 
lieginning, return lemainder. 

$ {variable##pattern} — Delete longest match from 
beginning, return remainder. 

${variable%pattern} “ Delete shortest match from end. 
return remainder. 

5{variable%%pattern} — Delete longest match from end, 
return remainder. 

$ {variable/pattern/string} —Replace first longest match 
of pattern in Kvariahle with Sslring, 

$ {variable//pattern/string} — Replace all matches of 
pattern in Svariable with $string. 

'fhere are several external utilities that alter strings: sed, 
dimame and hasename jump to mind, i'heh use can often be 
handled right within bash. Ihis is a useful technique to use if 
possible, as it’s more efficient to not liave to fork off other 
processes. 

Two months ago, I wnjte about how i auK^matically |xjpulate 
a variable—}DB“With tlie path for my locil Dro(>hox Iblder. Lets 
use the variable to paitem match on. Cunently, SDB contaias: 


/\blumes/homes/Users/Shared/marczak/Dropbox 
If we just want die path leading up to where the Dropbox 
folder is stored, we can quickly retriei^e it with a pattern match. We 
know that we simply want to remove the ‘'Dropbox" portion- 

$ echo ${DB%%Droplxix) 
/Vedumes/homes/Users/Shared/marezak/ 

In fact, we can more generically replace the dirname utiJity- 
S[path_variable%/*} 

The opposite of dimame is hasename, wliich returns only the 
file or direaory name, void of die leiiding path. In our case, that's 
a litde useless, since we know die name will always be “Dropbox". 
However, like the dirnanie replacement, we can make this a bit 
more general: 

$ echo 
Dn>pbox 

The replacement operators allow Ibr a lot of flexibility. These 
on replace most liasic uses of sed. Let's kxik at a basic example; 

$ name="Ed Marezak" 

$ echo ${name/ VI 
Ed 

As 1 mentioned earlier, using the hash built-in can lx? more 
efficient. Now; if you have only one line in your script that c’alls an 
external utility, yoLi're not lil<ely to notice a perfomiance fenefit. 
However, what il' that one line is called repeatedly? 
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I had the need to take a large list of filename pointers and 
strip a trailing chaiader C each. Used in a loop, the bash 

version beats using sed: 

toz filenaEie in $[getnevflies): do 
report($(filename/ 
done 

Many scripting languages have a split key^^ord (or 
equivalent), which returns individual elements of a single string 
separated into fields by a common character. In shell scripting, awk 
is often the natural place to turn. However, for simple splitting, you 
can stay right within t>ash. For example, the SPATH variable is a 
single string, with components separated by a colon character If 
you were to replace the colon witli a linefeed character, you could 
display or pipe each component into ancither utility as individual 
items. You could use awk to separate each field, or, a script like this^ 


Just remember tliese operators and try diem before shelling 
out to sed or other utility. 

Length Operator 

The last string operator we'll cover is the length operator. This 
is a natural replacement for shelling out to “wc -c" (count 
characters). If you need to obtain the length of a string or list, the 
lengtii operator may just solve your needs. 

${#variable} — return the length of the variable as a string. 

You may need to te.st the lengdi of a .string for some purpose. 
For example: 

if [[$[#!) -gt 10 ]]: then 
etzho “String too longl" 
fi 


IFS=':' 

for 1 In $PATH: do 
echo $i 
done 

However, you can make tliis a clean, neat onediner: 
echo 'e SfPATH//’/'\n'1 

The string pattern substiaition replaces ever occurrence of a colon 
with a '\n' string (note die double forward-slash characters), Tlie - 
e flag to echo forces it to treat *\n' as a linefeed character, giving 
tliLS one-liner the same behavior as die loop shtmii just above 
( where, in all honesty, you should also save SIFS piior to the kxip, 
and tlien restore it afterwrtrds). 



If the first parameter passed into the .script or function is greater 
than 10 characters, the conditictnal will succeed and print ""String too 
long!"" Nicely, this also works wtdi lists, such as 

if [[ Sl#l -It 3 ]]; then 
echo **Too few parameters U 
fi 


This snippet of ccxle complains if there are less than tliree 
pammeters passed into die script or function that it is contained in. 

Conclusion 

bash has sfrme great functinn;ilit>’ that is often overlooked. 
Additionally, calling external uiiliw programs impacts performance 
in terms of speed and resources. While it isn't always a dire need, 
there are many cases wJiere you want to Lie mindful of resources 
used (disk, CPU, diread count, etc.)—a shared server, for instance. 

Media of die inondi: “Results Widiout Audiority” by Tom 
Kendrick. IVe tnenrioned projea management Ixxiks in the past, 
and tliis is anodier gem. We all lead projects in some manner, 
however, few of us have fonnal Qiiining. While tooks alone aren’t 
a complete replacement for training fand acmal doin^, they’re a 
good start and can plant ideas for you to try, “Results Without 
Authority'" probably applies to many of us: how^ to lead a projea 
when you’re not directly a niitnager over many of tlie people 
involved in getting die project to completion. 

1 hope you're gearing up for die first MacTech Conference: 
http/(vwwniadedi,a:mXm(W^ us in Los .Angeles for diree days 
of learning and interaction wiili yotir jx^ers. I’m thrilled that this is 
taking place and hope you are tool I hope to see you in L.A.! 

\\\\ 
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CoreSec 




Security topics for administrators and programmers 


By Michele (Mike) Hjorleifsson 


Welcome 

Welcome to the first installment of CoreSec, a continuing 
series of articles to ans^^er questions, address coininon concerns 
and introduce security technologies and concepts. In the following 
months, we will delve into interviews, topical dlsoissions, how-to 
articles, and Q&A from you, tlie reader Why tlie name Xoa^Sec?" 
At its core, OS X is UNIX 3 compliant. Its core compiments all 
address security in one form or anotlien Wliether it's pnitected 
memory, secured virtual memory or email encryption, security 
ains through the core of OS X and hence tlie name “CoreSec." 

Why 

Tlie term “security guy" w’as akin to the term “computer guy" 
ten or fifteen years ago, A “.security guy" would be expected to lx? 
the point person on all things security related, but like the “PC 
guy" or “Apple guy" of years ago, the security technologies 
lequiienients, mandates and legislaiion have fxanched the security 
industry and technologies into many different areas tlint today 
seem to touch all of iis regardless of our position, industry or title. 
For instance, a movie editor rmiy iiave .security’ concerns alx>ui 
leakage of confidential information on their movie or corporate 
video pnijeci. Doctors are all too tamiliar wltli tlie acronym HIPPA 
and the related protection of patient infonnation. Banking, 
seamties and stock lirokerages deal with a myriad of security 
concerns and legislative requirements. Accounting firms nuust 
ensure tlie confidentiality and security of tlieir customers' ciita and 
subsequent tninsmission of tliat data. Last but certainly noi least, 
any orgiinization accepting a credit card for their brick and mortar 
or wel>based transactions have a host of regulatory requiiements 
they may not even be aware of until it is too late. The goal of this 
column is to provide infonnation, links to resources and 
discussions to aid you in your day-to-day life addressing security 
tasks and concerns. 

Lefs start with a set of regulatioas you may or may not l^e 
aware of but are subject to if you engage in acceptance of any type 
of LTedil card transactions. This literally means any acceptance of 


ANY transaction regardless of whether it is once a year or many 
thousands of times a day. 

PCI (payment curd industry) regulalioas (.set by the PCI 
Security and Standards Council) are a set of rules and requirements 
enforced on all merchants, pixxessors and ciedit card companies, 
PCI was initially established to avoid government intervention in 
the credit card industry. The idea liehind PCI is that the industry 
can provide its own set of regulatory rules and requirements 
robust enough to protect consumer infonnation; aedit card and 
personal data and no governmental regulation or laws would be 
rec|uired. The outcome of that premise is yet to be seen but if you 
accept credit cards in any Ibnii (via well, phone, or in person) 
your organization is subject to these regulations and the 
sulisequent penalties for ignoring or violating the requirements. 
As you may have never heard of PCI, ii was established in 2(X}6 
and from tlieir website tlieir charter stales, “The PCI Security 
Standards Council is an open global forum, launched in 2006, tliat 
is responsible for file development, management, education, and 
awareness of file PCI Security Standards, including; the Data 
Security Standard (DS,S), Payment Apjilicaiion Data Security 
Standard (PA-DSS), and Pin-Entry l>evice (PED) Requirements." 
Wow; a lot more acronyms to memorize and confusing industry 
lenns from the credii card industry. What does it all mean? Well, 
simply put, they are file credit card police, providing and enforcing 
rules on merchants, software manufacturers, processor and even 
hardware manufacturers tliat work with credit cards. 

Since 2(X)6 the PCI-SSC has set and mcxlified its roles and 
regulations to address gicwing concerns about data loss, identity 
theft and credit card fraud and has added serious teeth to its roles 
and regulations to ensure compliance. Knowledge, or lack thereof, 
of the roles is not an excuse for non-compimnee and will not 
excuse an organization from the penalties enforced if the. 
regulations are not complied wifii. For the smallest merchant (one 
accepting less than 20,000 in aedit card transactions per year), 
fines c'an range from $10,000 to a maximum of $150,000. So lefs 
take a look at some of file basic rules that apply to you, the retail 
or web mercliant. DSS (Data Seoirity Standards) layout the 
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~ RofifoJ.. N. RidgeviXe, OH 


To learn more, visit CarMD at 

www.CarMD.com 
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requiriemenrs for you, the web or retail merchant. Tills will also 
include consultants, doctors, dentisLs and anyone who accepts a 
credit card for payment. The requirements are split into six main 
categories wdtli up to three topics per requirement. The details on 
the level of protection mandated lor each of these requirements 
depends on the numlx?r of transactions and tlie position in which 
your organization resides in the credit card processing chain. For 
instance, a credit card processor has much more stringent 
requiremenLs than a web store or doctor’s office. 

Many oiganizaiiaas I speak with about s^Tority aren’t even 
aware that they are subject to these rules, regulations and 
recinirements and have been accepting credit cards for years. 
Fortunately, OS X has many builtdn tools to help you meet the 
requirements. Let’s take a look at tlie DSS categories, topics and 
explore how^ OS X can help you address them. Note that although 
they are not discussed in detail, each topic has specific 
requirements. 

Category One: Build and Maintain a Secure Network 
Topic One: Install and maintain a firewall configuration to 
protect cardholder data 

Topic Two; Do not use vendor-supplied defaults for system 
passwords ik other security parameters 

OS X provides a l)LiiU in firewadl IxitJi on the standard desktop 
operating system as well as a more granular contiolled firewall for 
OS X server, tills can easily meet the first reciuirement. Password 
policies enforced by Open Directory' on OS X server can meet the 
.second requirement and enforce strong passw^ord and password 
renewal policies. 

Category Two: Protea Cardholder Data 

1bpic One: Protect stored catdholder data 

1hpic Two: Encrypt iransmi.ssion of cardholder data across 

o|x^n, public network 

Tlie first topic regally depends on whether you even store 
c’ardholder cLita and the appliciiion used to store it. For instance, 
if you use a service such as authorize.nei you should never liave 
to store cirdholder d;ua so tliis topic does not apply but tlie 
second topic would and am Ix" addressed easily by ensuring tliai 
you are transmitting this data over SSL and receiving the data from 
your clients from your web appliaitioas on an SSL-secured 
welipage/vvebsite. OS X [irovides a tix)! called Certificate Assistant 
(launched from Key Chain Access located in your Applications > 
litilities folder) that can request and install SSL certificates for yrmr 
we}:jsite. 

Maintain a Vulnerability Management Program 
Topic One: Use and legularly update anti-virus softw^are 
Topic Two: Develop and maintain secure systems and 
applications 

The first topic, wTiile widely considered unnecessary on OS 
X sy'^stems, Is a good precaution and on OS X serv^er diere is a free 
anti-virus engine included for desktop sy^stems. You can dow'nload 
iAntiVirus, Norton’s AntiVinis or a host of otlier commercially 
available tools. Alternatively, you am download and instafi 
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No need to manage your mailbox storage quotas. 

Spam & Virus Protection 

Comprehensive protection against unwanted email. 

Entourage & Mac Mail Optimized 

Email Performance you would expect on your Mac! 

Better Mobility 

Synchronize your iPhone with our FREE ActiveSync 
service, the fastest, most reliable synchronization 
service available. 



www.appriver.com/mac 
sales@appriver.com 
(866) 223-4645 









ClamXav; an open source antivirus application from 
hftp:/Wv.dcnww.cnTi If your organization develops theii' own web 
applications, desktop applications or web store you must ensure 
that the latest security patches are installed, that you are using 
encryption such as SSL to encrypt and protect cardholder data. 
Since these requirements are very specific to die programming 
technology' you are employing we will have to leave tliis to your 
application developer to research. 

Implement Strong Access Control Measures 

Topic One: Restrict access to airdholder data by business 
need-to-know 

Topic 1’wo; Assign a unique ID to each person with computer 
access 

Topic Tliree: Restrict physica] access to cardholder dato 


Regularly Monitor and Test Networks 

Topic One: Track and monitor all access to net^^ork resources 
and cardholder data 

Topic Two: Regularly test security systems and processes 

OS X provides robust logging opdoas for its firewall^ file 
access and network access, which can lie an effeaive way to meet 
the reciuiremenLs of the first topic. The second topic is more 
procedural; a policy and test plan should be implemented by your 
oiganizatinn to ensure compliance with all tlie categories and 
asscKiated topics/requirements. 

Maintain an Information Security Policy 

Topic One; Maintain a policy tliat addresses information 

security 


Topic One is more of a business proc'ess than a computer 
security item but ACLs (access control lists) can be used to control 
access to dcxuments and applications containing any cardholder 
data. Additionally, most accounting and card processing 
applicatioas have role-ba.sed authentication, providing you with 
granular control over who has access to this data. The same 
techniques can l>e applied to meet the second topic’s 
requirements. Die third topic is st-iecifically a business proc\.\s.s, 
though the Mac comiiuters that store this ckita can tx.^ set up with 
firmware passwords or security devices such as smarncarcls to 
restrict physical access to the Mac computers storing the 
cardliolder data. 


PLEASE-CARE 

ONLINE 


The last category and topic are addressed at the 
organizational owner or responsible party and mandate the 
documentation of a security policy and subsequent reviews of the 
policy to ensure tli^it it effectively addressses the compliance witli 
the aforementioned categories and tlietr a.sstxiated topics and 
regulations. For more information on PCI DSS you can visit 
http6:/^wftvpd90mrit)^<Tdcids.crg4aGurity_^cndcrtk^ which 

amtains ilie regulations, reciuiremenls, and dozens of educational 
msourcCuS, 

Conclusion 

As witnessed by the PCI dLscus^sion, sometliing as simple as 
accepting a CTedil c’^.ird for payment, donations or surety of 
payment has securiy implications that need to be addressed by 
your organization. It is my goal in tliis monilily column to make 
you aware of issues such as tliese and help you address them in 
your organization. We strive to make this column as pertinent to 
you, the reader, as f'K^ssible so please feel free to email 
mikdi^odedi.ccm and provide feedliaek or topics you would like 
to sec addressed in oiti' U|Xoming editions. Stay safe; stay secure. 

iW I 
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Introduction 


Apple's iPad shipped in the United States on April 3rd, 2010, 
Like the iPhone before it. even though it was not specifically 
designed for use in an enterj^^rise setting, it will find its way into 
large organizations, 

The first time my daughters ,saw my new iPad for tlie first time, 
they each exclaimed, "Ifs a giant iPhonei” And of course, from one 
perspective, it is for prol.iabiy more acctirately, a giant ilA>d Touch). 
Since the iPhone is being used successfully in enterprise 
environments, it smnds to reason that the iPad will have its uses as 
well. 

So let’s quickly review die enterprised'riendly iPhone/iPcxJ 
Touch features tliat carry over to die iPad. 

Email/Calendar/Contacts 

iPad's email client can connect to enteiprise email systems; 
both those based on standard liMAiVSMTl^ services as well as 
Mienxsoft’s Exchange via AttiveSync. Exchange calendars and 
contacts can also be syncect with an iPad. If your organization’s 
calendar supports WebDAV or the iCaJ standartl, you can at least 
get a read-only version of your w^ork calendar on the iPad. 

Becau.se of tlie extra screen space, iPad’s email client is more 
c'apable and easier to work with tlian the iPhone version, lire same 
mostly applies to iPad’s calendar applic'ation as well, 

Web access 

Safari on the iPhone raised the [>ar for die mobile web. With 
die exception of Flash, for die Hist time you could use Teaf weh 
pages on a mobile device. iPad’s Safari is faster and makes great 
use of the added saeen space, if you've lieen able to use your 
organization’s web appEcadons on die iPhone, the il^ad will wtjrk 
even better. 

802,1X and VPN 

Like die iPhone, the iPad supports the enterprise 802, IX Wi¬ 
Fi standard many VPN implementations, I had no trouble 
connecting my iPad to my organization's secure Wi-Pi network, I 
was unable to test die VPN due to policy restrictions in my 
organization. 


52 JUNE *2010 


Configuration profiles 

With iPhone^ OS 2,0. Apple introduced the iPhone 
ConOguration Utility, whicii allowed administrators to create 
configuration profiles for the iPhone (and iPod Touch), When these 
profiles are installed on an iPhone, they can configure the device 
for email access, calendar access. 802. IX, Vl^N. and more. In my 
testing, existing configuiation profiles generated for the 
iPhone/iPod Touch wTirl^ed as ex]xx.ted on the iPad. This allowed 
fast, secure configuration of my iPad to connect to my 
Qiganization’s email, caienckir, and secure w^ireless network. 

The iPad sliares some of die iPlione’s shoncomings for 
enteiprise use. For example, the initial setup requires connecdng to 
il'unes on a Mac or PC. J'liLs ts workable for personal use, but if 
you tieed to setup and configure a large number of iPads in an 
enteiprise environment it seems like an ann{>ying extra step. 

Laptop Replacement? 

So you’ve probably already figumxJ out dial the iPad is more 
aipa]:)!e and at least as u.sefiil as an iPhone or iPod Touch in an 
enteq^rise setting, but what you’re really w^ondering is - can an iPad 
possibly ix^ used as a laptop or ^en desktop replacement for some 
users;' 

Let’s Icxjk at a few^ diings the iPad cun do dial die iPhone 
(currendy) canT 

Display 

First; the screen size. The iPad’s 9.7-inch diagonal, 1024x768 
display is closer in size to a laptop or desktop display (and the 
.same number of pixels as many 15'inch computer displays a few 
yeai's ago). The extra screen real estate makes you more productive 
in mail and w^eb browsing. It also makes remote access applications 
like VNC, RDP, and SSH applications much more usable lo connect 
to, view, and control remote machines, making it Ikr more practice 
to use an iPad, rather than an iPhone/rPod for systems 
administration tasks. Other classes of application.s can present 
much more information at once, again making you more 
productive. 
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Hardware Keyboard 

Stronclj you can a‘?e a hardwane keylxiard with the iPad. 
Apple offers a keyboard dock, which integrates a keyboard with a 
30-pin cx>nnector dock. Since the 30-pin connector is on the 
“bcxtom” of the iPad, that limits iLs use to portrait orientation. If you 
want or need to use the iPad in landscape orientation, the keylToard 
dock is of no use. And you'll almost certainly want to change the 
orientation of the iPad from time to time - some apps, like Keynote, 
worii only in landsc'^ipe orientation: odieis, like Pages, befuive 
differently depending on the orientation. Pages hides all of its 
controls in landscape mode. If you want to format your text or 
insert pictures, you need to turn the display to portrait mcxle to get 
the controls to appear. 

Using a BluettKJth ke^^berard might be a iTetter choice, as it can 
be u.sed with any iPad orientiUion. Apple offers a compact 
BlueUx>th keyboard, but any Bluetcxith-compatible keyboard 
should work. 

Using a hardware ke^^b^ard transfomis the iPad from being a 
“giant iPod Touch'' into an almost-laptop - you can imagine 
yourself asing it for more than mail and web browsing. Some Mac 
keyboard shortajts work as you'd expect - the key conil:)mtions 
for Copy, Cut, Paste, Selea AH and Undo all work. Others, like the 
traditional key combinations to tbrmat text as Ixjld, italic, 
underlined, etc, seem to be unsupported. 

iWork apps 

Tliird: tlte iPad can run some Office-like apps; Apple offers 
iPad versions of Pages, a word prexessor; Numbeis, a spreadsheet, 
and Keynote presentation stift\\'are. If you are a Mac user, you 
probably have at least heard of the Mac versioas of these 
applications, like their Mac counterparts, the iPad versioas can 
import and export Microsoft Office documents as well as work with 
their own document fomiaLs. 

VGA output 

Fourth: with Apple's iPad-to-VGA adapter, you can conned 
your iPad to most business pn^jedors and use the iPad for 
presentations, ^X^en you playback a Keynote presentation with the 
adapter attached, the presentation plays back on the attached 
monitor or projeaor, and the tPad display is used for controlling 
playliack and a virtual “laser pointer” 


Video Out X 
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Tap to advance 

fouEli and hold la slad Ibsqt pcMittor 


Figure 1 - Keynote's controls when presenting to an external display 


Enterprise Shortcomings 

So, back to the question at hand; can an iPad possibly lie used 
as a laptop or even desktop replacement for some users? 

Sadly, rd have to say the answer for most users is “not yet,” 
especially if you need to do document cTcation or editing. There 
are just too many issues, most involving workflow. 

Printing 

Even chough the “paperless office” is the future, tlie future isn't 
here yet. Enterprise works still need to aeate paper dociimenLs. 
Unfortunately, iPad has no integrated printing mechanism. You 
can't prim from the mail applic'arion, Safari, or the iWork apps. 
Apple .suggests you transfer the documents to a Mac or PC and print 
from there. The App Store offers a few apps for printing, but none 
are integrated with the OS. 

File transfer 

Document mansfer is annoying and clunky and painful. Apple 
suggests you use iTunes to transfer documents to and from die 
iPad, 'rhis, of course, requires you to connea the iPad to a Mac or 
PC with a cable and use die iTunes interface to choose documenLs 
you want to transfer. Again, this might lie an acceptable workflow 
for home use, where you just want to move .some dtxumenLs 
between your personal Mac and your personal iPad, But if you 
want to grab a copy of a dcxaiment fnim a colleague, having to 
connect your iPad to their Mac jast seems wrong. 

You can also transfer documents via etmil, and if they are a 
fonnat that one of the iWork apps can import, when you preview 
the dexument in the Mad application, you'll see a button to open 
the document in the relevant iWork app. This, right now, is 
probably the 1x^1 choice for ad-hoc document transfer, because it 
can be done wirelessly and requires no special setup. 

The final suggestion from Apple is to use die public Lieta of its 
iWork.com service, which allows you to publish and share iWork 
documents via the web. I W 2 is able to publish an iPad-edited 
document on iWork.com, and import another document diat I had 
published from Pages on a Mac. This workflow means, diougli, ihit 
you could have three or more copies of the document to reconcile 
- a copy on a Mac, the copy hosted at iWork.com, and the copy on 
the iPad. Keeping all this stntiglit seems error-prone. 

Apples iDisk - part of die MobileMe services - seems like it 
might be another option. As of this writing, Apple had not yet 
updated its iDisk app for iPad; perhaps in die future one might lx» 
able to use iDisk for document transfer. 

Document conversions 

Assuming you’ve found some way to get a dtxumenl onto the 
iPad, and youVe purchased tlie relevant iWork app, your challenges 
are not at an end. If your documents originated in Micrexsoft Office, 
you may be able lo open them in Pages or Numbers or Keynote, 
but not with 100% fidelity. In Pages, .some Word document 
fomiatiing w^ill be last, fonLs will be substituted, and more advanced 
features like Track Changes” will lx turned off. Nunibei^ likewse 
supports only a subset of Excel features. Imagine a workflow in 
which you worked on a document in Microsoft Word on a desktop 
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a^mputer, emailed it to your iPad, imported it into Pages, worked 
on it, exported it back to a Word document, emailed it back to your 
desktop computer, and re-opened it in Micrasoft Word. That 
workflow was painful to write; Id imagine it would be much worse 
to actually do on a day-today basis. 

If you think the main pain is caused by the Office-to-iWc3rk- 
and-back conversions, and your problems will be .solved if you use 
iWork ‘09 on the desktop as well as the iPad, you’ll be disappointed. 

iPad's iWork applicatioas, though impressive as a rethinking 
For the multitouch OS on the iPad, are still essentially lite" versions 
of the corresponding Mac desktop applications. All three 
applications support a subset of the fonts available on the desktop, 
and each app drops some features of its desktop version. 

Let’s consider Keynote as an example. While it would be 
tempting to hope you could take an existing Keynote presentation, 
transfer to your iPad, hit the road and present it from your iPad, in 
practice you‘11 almost certainly have to make some clianges to the 
imported document so it will display acceptably. When importing a 
fairly simple Ke^mote presentation 1 aeated over a year ago, I found 
the iPad version cmldn’t display one of the graphics on a slide and 
substituted the Monaco font I liad used for shell scripting examples 
on several otlier slide wiili tlie Helvetica font, making tiie examples 
hard to distinguish from cjilier text. Botli [problems were easy 
enouglt to fix, but the point remaias tliai Keynote for iPad is not 
100% compatible witli Keynote for JVLtc OS X. 

If you use inore advanced Keynote features, you may find they 
also are not supported on the iPad, leaving your presentation 
almast unrec:ogni7ab]e. Not all transitions, animaticms, and chart 


types are supported. Tables may be reformatted. Early rCTiewers 
have noted that not only does Keynote for iPad not support 
speaker's notes, it actually deletes the notes on import. This makes 
creating a presentation on a Mac, traasfening to an il^ad for 
tweaking, and transferring back a dangerous operation. Oddly, 
when using Keynote with the iPad'-lo-VGA adapter, there seems to 
be plenry of room for speaker’s notes on the iPad's display - even 
with the on-screen playback conuoller, and displaying speaker's 
notes dcjesn’t seem computationally complex, so tills is a curious 
omission. 

Working with iWork 

You definitely can get more “business'’ use out of an iPad than 
an iPlione; but in mast cases you1l .still need a laptop or desktop 
c'omputer available to you to finish a job 100%. For example, I used 
an iPad with the Apple Bluetcxah Keyboard to type die first draft of 
this column in Pages. 1 later emailed die dcxument to myself and 
copied and pasted the text into a Word template for diis column, 
where 1 finished the formatting and editing, 

There are elements to using the iJ^ad for this sort of work that 
take a little getting used to. In Images for iPad, it’s a bit liberating to 
not have to worry about saving the dtxument. Pages on die iPad 
autoniiitically saves your work, as do Nutnbers :ind Keynote. Hitting 
the home button, which quiLs Pages so you am open a different 
app, like Mail, is initially a hit disconcerting. But switching to 
anotlier application Is fast, and when you return, Pages almost 
remcmters where you left off (the text is in die same position, but 
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tlie insertion point is last), Its almcxst as nice as “real” multitasking. 
When iPhone OS 4.x makes it to the iPad in the fall, presumably 
tlie experience of .switching to other apps and etching liack will 
be even nic'er, but it’s acceptable now; 

Unlearning over two decades of the mouse, menu and 
key board interface paradigms is another challenge, and since I can't 
yet give up my laptop, I can’t really unlearn; instead I have to switch 
modes in my brain. 1 keep reacliing for a mouse to move the 
insertion point to make a selection, and missing a menu bar. I tlilnk 
the more direct manipulation model in the iPad is the fuiuie, 
thougli, and as I get used to the iWork for iPad riser interlace, I will 
become more proficient. (As 1 wmte tliis, it’s been less tlian a month 
since die iPad hit store shelves in die US!) 

Still, in my short time with die iPad and die iWork apps, 1 can 
imagine doing light work in Pages and tweaking and giving 
presentations in Keynote. I find it harder to imagine doing any 
spreadsheet work at all in Numbers -1 diink it's the app that suffers 
most from throwing out the menu/mouseAeyixiard interface. 
Working in Numbers feels like working on a spreadsheet with giant 
oven mitts on your hands. 

Some notes on the iWork apps: 

Pages 

If all you need to do is wote text, using Pages with a hardw are 
keyixiard works well. Witli die il^ad in landscape (mentadon, all the 
user interface controls go away, lemming a blank, clutter-free page 
for writing. Rotate die iPad to ptirtrait orientation, and controls for 
kinnaning, iaserting pictums, charts and graphics appear. 



Figure 2 - Pages formatting controls 


many interface conventions; iPad throw^s out most of them. Expect 
it to take time to attain productive in iWork apps for iPad. 
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Figure 3 - Editing a Numbers document 


Keynote 

Since a Keyntxe document lypically consists of slides with 
small amounts of text and lajge grapliic elements, it’s probably the 
Ixfst suited to the direct manipiilatinn model of iPad OS and die 
iPad iWork apps. 1 found it pn^rxy easy to manipulate an existing 
pmsentation. Keynote w^orks only in the landscape orientation, but 
diat wasn’t a real problem, I can actually imagine using this 
application w iihout a hardware key!x>aid. 



Figure 4 - Editing a Keynote presentation on the iPad 


Numbers 

tills is die app where die cfninges in user inlcrhice make for 
tlie steepest learning cuive. 1 tried to make a simple sprciidsheet 
tliat replicated a multiplication table. 1 was successful, liut it took 
me almost hall an hour. The same task on a laptop or desktop 
would have taken me around a minute, Tliis is not to say that a 
simple spreadsheet wxiuld always tike so long; I’m sure as I got 
used to die interface 1 could work more quickly, (And to lae fair, I 
have never used Numlaers on the Mac - all of my spreadsheet work 
has Ixx^n widi Excel.) But it does underline the fact that iPad is a 
totally new' platibmi - in many ways it’s harder to move from Mac 
to iPad di:m from Windows to Mac. Windowes and Mac OS X share 


What about iPhone OS 4? 

Five days after the iPad shipped, Apple announced iPhone OS 
4 would ship in the summer, and would come to iPad in die fall. 
Of the details shared so far, there are a few' that wotild be useRil to 
enteiprise iPad users. 

Multitasking 

The new' multitasking features in iPhone OS 4 will definitely 
help users be more productive on die iPad. While switching 
l:»etw^een apps is pretty fast now^, apps don’t always store their state 
wdtii 100% fidelity, so w'hen they relaunch, you may have to take 
some action to get back to wliat you were doing wlieri you 
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switched away from tlie app, Tlie new fast app switching and 
better saving of applic'ation state will make it much faster to switch 
from Pages to email and back without losing your place. 

Enterprise features 

Apple also announced more enterprise-ftiendiy features, but 
did not go into much detail yet. There are new data protection APIs 
to aUow' apps to enciypt private data. New support for '‘Mobile 
Device Management" will allow enterprises to more easily deploy, 
ct^nfigure, manage and update iPhone OS devices. Enterprises %vill 
lx? able to deploy internal apps wirelessly - no more needing to 
c<innect the device to iTunes to download internal apps. And tiie 
improvements in mail allow- multiple Exchange ActiveSync 
accounts, a unified inbox, and oiganizaiion of messages by 
conversation tlireads. 

Maybe more? 

Since the iPad is not getting tlie iPhone OS 4 update until later 
in the fall, hopefully tills is a sign tliat a few moie iPad-.specific 
feamres are on their way. If tliere are additional fe^itures, maybe 
some will address a few of tlie enterprise workflcrw issues (file 
transfer, printing, dtxiiment compatibility) weVe kxiked at here. 

Don't forget tliat Apple and tliiid parties can also update the 
iPad experience tlirougli tlie ielea.se of new^ and updated 
applications via the App Stoie. We may not have to wait untiJ the 
fall for updates of interest tc) enterprise. 

Conclusion 

As of this writing, it’s lieen less than a month since Apple has 
released the iPad. In many ways, iPad is a completely new 
platform, even nion? different from the Mac than tlie Mac is from 
Window^s. While Apple didn’t design tlie il^ad with enterprises in 
mind as a primary' ctistomer, it’s not too much of a stretch to predict 
tiiiit iPad w'ill find its w'ay into large organizations as weO as the 
iPhone has already done. 

1 expect this new' platfomi to evolve and grow over time, just 
as the Mac lias evolved from ixs Ix-ginnings on a machine witli a 1 
Ml lz ixocessor, 128K of RAM, Lind a nine-inch black-and-wliite 
display. Whether the iPad platfonn in its cuneni state Is useful in 
your enterprise is ultimately up to you to decide. Even if the iPad 
probably c^an’t serve lls a laptop or desktop replacement machine 
right now' for most enterprise users* you owe it to yourself to keep 
an eye on tliis platlbnn. as tliere will be many more devices like 
tills in tlie fiiture* and their capabilities wall only continue to gniw. 
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BBEdit Language Modules 

Adding new language support 
to BBEdit and TextWrangler 

^ by Jo$S R.C. Cruz 


Introduction 


Today we explore another way of extending BBEdit, the 
stalwart text editor of tlie MacOS X platform. This tune, we will 
learn how to provide support to the editor for other languages. 

To start, we take a close look at BBEdit’s language feature. 
Then we learn two ways to build a language module. Next, we 
study tlie data structures that we need to process a target 
language. And we end by writing two language modules for 
that other OS X stalwart, AppleScript. 

Readers are expected to know theii' way around Xcode 
and BBEdit, The modules featured here also work with BBEdit’s 
free sibling, TextWranger, with some small variations. The 
Xcode projects for the modules are available from the following 
MacTech ftp site at fip://ftp mactech.com. 

The Language Features 

One notable feature of BBEdit is its ability to recognize 
and handle a wide range of computer languages. For instance, 
when it loads a text file written in a specific language, it marks 
the reserved ke^^'ords in the correct color. 

Next, BBEdit c:an .scan Uie text for valid blocks. A block can 
be a function, a property, or even a global. Once its scan Ls 
over, BBEdit displays tile name of each block on a pop-up 
menu (Figure 1). Users can then jump to the desired block by 
selecting its name from the menu. 
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Figure 1, Displaying text blocks. 


Anotlier aspect of BBEdit's language feature is in its Search 
menu. For instance, choosing Go to Function Start places the 
insertion airsor liefore the block’s rmme (Figure 2). Conversely, 
choosing Go To Function End places the cursor before the block’s 
ckksmg to^fL But choosing Go to Next Function selects the name 
of the next block. And choosing Go to Previous Function selects 
the name of tlie previous block. 
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Figure 2. Navigating text blocks. 


Finally, BBEdit has the ability to quejy^ a selected keyword from 
the right reference source. Suppose you selected the word 
'"register” as shown in Figure 3, To start a query, bring up the 
contextual menu and choose the item Find in Reference. Since 
die target language is ANSl-C, BBEdit sends the querc? to Apple’s 
Developer Connection website. If tlie language were Python, 
BBEdit will load Python’s HTML documents, whase location is set 
by tlie environment variable PYTHONDOCS, Or if this is just a 
simple text file, BBEdit sends the query to the Dictionary 
application. 
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Figure 1. Cross-referencing a selected word. 


Now BBEdit has l>Liilt-in support for most common 
languages, which inciudes C, C++ and Ohjcctive-G. It even 
supports common scripting languages like Pytlion* JavaScript, and 
hash. On the other hand, BBEdit lacks support for languages like 
AppleScript, Modula, and SPICE. To handle these niche languages, 
we must supply a ciastom language module. 

The Language Module 

The langinge iiKxlule provides BBEdit with details about a 
target language. For instance, the module lists the reserved 
keywords that a given language uses. It sets the correct color 
schemes for each group of key^^ords. And it defines the block 
structures aDowed by the language allows. 

To use a language niodtile, it must he inside the user 
directory -^/Libr ary/ApplicationSupport/BBEdit/ 
Language Modules/. If this directoiy does not exist, you will 
liave to create it using tlte Finder. Once you liave installed die 
module, iTuike sure to restart l?BEdii in order to activate said 
module. To confirm if the module has activated, ch{)o.se 
Preferences from the BBEdit menu. Then select the entjy 
Languages to display the correct panel, On that panel, the 
module’s target language should appear in the list lateled 
Installed languages (Figure 4). 



Figure 4. The Languages preferences panel. 


There are two types of language modules. The first type, a 
codeless module, consists solely of one plist file, Lnside thB file are 
nine key/value pairs, most of which define an aspect of the taiget 
language. Table 1 lists the nine keys that the module uses. Keys 
that are not in this list are ignored by BBEdit. 

Codeless modules are easy to assemble and test. All you 
need is a decent text editor, like BBEdit, and a good knowledge 
of the taiget language. On the other hand, these modules rely on 
BBEdit itself to correctly parse the language text. This means only 
versions 8.5 and newer of BBEdit can support codeless modules. 
For older versions of BBEdit, you may have to use a plug-in 
module. 

The plug-in module 

The plug-in module uses die &ime CFPlugin template as 
the tcxils plug-in. And it shares most of the key/value pairs that a 
codeless module uses. But unlike the latter, the plug-in mcxlule 
does the actual parsing the language text. 

Figure 5 shows the staicture of a typical plug-in mtxlule. Tlie 
MacOS directory holds the module's exectitable binary. Tile 
Resources directoiy holds any support files that the mcxlule 
needs. The Info*plist file set the module’s lx;havioiir. It holds 
die key/value pairs that descrilx^ the target language. It also holds 
key/value pairs diat descrilx^ the module itself. Table 2 lists some 
of the keys unique to the plug-in module. 

'llie plug-in mcxlide can do certain tasks not possible with 
die codeless mcxlule. For example, it can color each keyword 
based on context. It am loaite blocks nested in other blocks more 
accurately. And it am handle mcjre dian one target language. On 
the other hand, writing a plug-in modLiIe takes mc)re time and 
resources dian iis ccxleless kin. Plus, a pcx>rly written mcxlule may 
cause BBEdit to either freeze or crash unexpectedly. 


Foobar,bbLm 



Poobar 


Figure 5* Structure of the plug-in module. 
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Table 1. Keys of the codeless module. 

Key 

Type 

Usage 

BBEdit DocumentType 

String 

Defines the type of language module. Always set to 
CodelessLanguageModule. 

BBLMColorsSyntax 

boolean 

Controls syntax coloring. Set to TRUE to enable coloring. 

BBLMIsCaseSensitive 

boolean 

Controls keyword parsing. Set to TRUE to enatile case-sensitive 
parsing. 

BBLMKeywordList 

array 

An array of core keywords for the target language. Must not include 
user-defined terms like variables and function names. 

BBLML a n gu a geCo de 

string 

Sets the target language’s unique ID. Must be a four-byte string. 

BBLHLanguageDisplayName 

string 

Sets the official name of the target language. This name appears in 
the Language panel of BBEdifs Preferences window, 

BBLMScansFunctions 

boolean 

Enables function parsing. 

BBLMSuffixMap 

dictionary 

Sets the file-name suffix used by the target language. 

LanguageFeatures 

dictionary^ 

Sets the keywords and tokens that mark each language structure. 


Table 2. Keys of the plug-in module. 

Key 

Type 

Description 

CFBundleIdentifier 

Siring 

The plug-in module's tmiciue ID, written as a reverse-domain URL, 

CFBundleSignature 

string 

The plug-in module's unique type, always set to BBLM. 

CFBundleVersion 

string 

The module’s version string. 

CFResourcesFileMapped 

boolean 

The acce.ss state of the module’s plist resources. Always set to TRUE. 

com.barebones.bblmin fo 

array 

Start of the definitions of each target language. 

BBLMMainFunctionName 

string 

The main entry^ function in the plug-in module. Must be unique for each target 
language. 

BBLMCanGuessLanguage 

boolean 

Set to TRUE if the plug-in module can identify the target language based on context. 


The Language SDK 

To develop your own knguage module, you will need the 
latest SDK from Bare Bones S<)ftware, As it happens, that SDK Ls 
tlie same one used to develop a BBEdit tool plug-in. Not only 
does tlie SDK has the files needed by your language module, it 
also provides a template for a ctxleless mcxlule. 

You can get the latest copy of the SDK from this URL. 


The SDK contente 

The BBEdit SDK divides itself into four directories. The 
director}' CodeIes.s Examples holds three examples of codeless 
mcxlules. It alsci holds the template RIe that forms the basis of 
those modules. The Documentation directory has the files that 
describe how to build the modules. The file of interest here is the 
one named ''Writing BBEdit Language Modules’’ — it is available 
in both PDF and Microsoft Word foixiiat. 

In the Examples directory^ are the project directories for 
three plug-in modules. You will need Xcode to these projects and 
suidy their settings. Finally, in the Interface directory' are the 
header files that you will need to write your own module. These 
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files are separated into two sub-directories: Tools and 
Languages. The ones you should use are inside the Languages 
sub-direaory. 

The SDK header files 

Now all plug-in modules iKse the header file 
BBLHInterface. h. This file defines the flags and 
constants that a plug-in can use. h lists the messages that 
same plug-in can expect from BBEdit. The file also defines 
the utility routines that can aid the plug-in in parsing the 
language text. And it sets the data structures wherein a plug¬ 
in can store its parsed data. 

Some plugdn modules can also include the header file 
BBLHTextIterator-h, which defines the eponymous 
iterator class (Figure 7). This class supplies the means to 
parse and extract specific substrings frcjm the given text. 
Plus, it can handle multi-byte text encodings. On the other 
hand, the class remains undocumented. To learn how to use 
this iterator class, consult the sample projects 
PythonMachO-xcodepro j and TeXMachO-xcodeproj. 

Finally, plug-in modules can use the header file 
BBXTInterface *h. In this file are the constants, 
structures, and functions available to all BOFdit plug-ins. [n 
this article, however, we will not use any of the services 
from BBKTInterface,h in our plug-in module. 


Building The Codeless Module 

Our first language module will u.se AppleScript as its 
target language. AppleScript, as all you may know, is the 
native scripting language of the MacOS platform. It first 
appeared in the mid-1990s as a feature of System 7 Pro, 
Apple's first commercial OS release, Unlike most script 
language at the time, AppleScript has an object-oriented 
syntax. It can control a target application using a structured 
messaging system called AppleEvents. It can even gain new 
features via plug-ins called scripting additions. 

Now you can write the codeless module using any text 
editor, even BBEdit. You can also use the Property List 
Editor, part of Xcode's suite of tools, to edit your codeless 
module. If you decided to use BBEdit, keep in mind that 
BBEdit will not let you edit and test the module at the same 
time. A better approach is to write the module with one 
editor, such as TextWrangler, and then test the module on 
BBEdit. 

Defining the language support 

Start by copying the template file 
CodelessLanguageModuleTemplate p plist; then 
rename the copy as AppleScript *plist. Open 
AppleScript * pi is t in your text editor and search for 
the key BBLHLanguageCode, Set its value to ''ToyS'', the 
creator type for Apple's Script Editor, You can also use your 
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own four-character ID, but make sure to keep the ID unique 
to the target language. 

Next, locate the key BBLMLanguageDisplay^lame 
and set its value to ""AppleScript”. At this point your 
module's first set of keys will have die settings shown in 
Listing L Notice we left four of the keys at their default 
values. 

Listing 1-The principal module keys. 

AppleScript.plist 

<kGy>BlEditDQcuinGntTypG< /key > 
<string>CodelessLanguaaeHodule</string) 
<kGy>BBLMColorsSyntax</key> 

<true/> 

<key)BBLHIsCase3enEitive</key> 

<truG/> 

<kGy>BBLMLanguageCode</key) 

<string>ToyS</string) 

<key)BBLMI.anguageDi5playNaine^/key) 

<string)AppleScript <^/atrlng) 

<kGy>BBLMScansFunctions</key) 

<true/) 

Now locate the key BBLMSuf f ixMap. Change its value 
as shown in Listing 2. This key hold an array of possible 
suffices for the source file. In the case of AppleScript* we 


assume the files to use .applescript. Other possible 
suffices include .as, .sept, or ,applscrpt. Again, be 
careful not to use the same suffices for two or more 
languages. Otherwise, BBEdk may use the WTong module to 
parse the source text. 

Listing 2. Setting the file suffices. 

AppleScript.plist 

<key)BELMSuffixMap<7key> 

<array> 

<dict> 

<key>BBLElLanguageSuf f ix< /key) 

<string> *applescript</string) 

</dict) 

</array) 

Search for the key BELMKeywordList, and enter the 
values shown in Listing 3^ This is where we define the 
reserved words of the target language. The key holds an 
array of strings, with each element being a reserved word. 
Ail the reserved words are taken from the official Apple 
document “AppleScript Language Guide.” The array show^s 
only the reserved core words—it does not include words 
defined by a scriptalde application or by a scripting 
addition. 



Listing 3. Defining the reserved 
words (partial list). 

AppleScripLpiist 

<key)BBLMKGywcirdListO key) 

(array) 

<string>tel!</string) 

<s:tring>cin</string) 

<string>to</fitring) 

<string>Gnd</string) 

<strlng>return</string) 

<strlng>conslfiering</string) 

<string>ignoringC/string> 

<string)tiiaeoiit</ string) 
<strlt]g>tratiaaction</ string) 

<string>property</string> 

<striug>globai</string) 

(string)lncal</string) 

<1— 

fsir A kie sample project ... 

—> 

(/array) 

Finally, locate the key Language Features and 
enter the key/value pairs listed by Listing 4, This is 
where we define much of AppleScript's syntax 
structure* For instance, block comments in 
AppleScript start with a ' (*' token and ends with 
a ' *)'. But inline comments start only with a 
' token. Also, AppleScript variables and values are 
written in alphanumeric characters. Plus, variables 
can use token (0x5f) to separate parts of 

their names. Functions and procedures, called 
ha?tdi&rs in AppleScript, begin with the reserved 
word prefixes ' on' or ^ to V. Statement blocks 
start with a 'tell' prefix and end with an 'end 
tell' prefix, 
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Listing 4. Defining the language 
features (partial list). 

App leScript.plist 

<key>Language Feattires</key> 

<key>Prefix for Functions<7key> 

<string>on<y string) 

<key>Prefix for ProcedtireeC/key) 

St rlng>to</ string) 

<key>Glose Block Comments</key) 

<strlng>*)</string) 

<key>Close Paranieter Li3ts</key> 

<string>)</string) 

(key)Close Statement BlDcks</key> 

<strlng>end telK/string) 

<key>Clo3e Strings K/key) 

<string)"(/ 3 tring) 

<key>Close Strings 2</key) 

<string)^(/string) 

<key>Tdentifier and Keyword CharaGters<7key) 
<string)01234567SgABCDEFGHIJKLMNOPQRSTUVWXYZ 
_ah£ 2 defghijkimnQpqrsttivvxyz< / string) 
<key)0pen Block Comments(/key) 

(string) (‘(/string.) 

<key>0pen Line Coniments</key> 

<string>-“</string) 

<key)0pGn Parameter Liats</key) 

(string)((/string) 

<key>0pen Statement Blocks</key> 
<string>tell</string) 

(key>0pen Strings l<7key) 

(string)"</string) 

<key>0pen Strings 2</key) 

(string>^data</string) 

<1— 

for a complete list, see the sample project ... 


Now readable slrtngs in AppleScript are enclosed in double 
quotes (0x22), just like in other modern languages. If the 
string uses special symbols, each symbol will l)e preceded 
by the escape token ^ \ , Then there are the raw data 
strings^ These start with a ' «data^ token and ends with a 

* a * token. In between these tokens are the data bytes 
rendered as a hexadecimal string. Finally, it is possible for a 
string to contain a newline character (0x0a). In this case, 
the closing quote will appear on a separate line. 

Installation and testing 

To test the codeless module, first copy or move the plist 
file to the following directory. 

"'/Library/Application Support/BEEdit/Language Support/ 

Quit BBEdit if it is still running; then relaunch it to enable 
the module. Now choose Preferences from the BBEdit 
menu. From the list of preferences panels, select the entry 
Languages. You should see an entry tor AppleScript on the 
listbox Installed Languages. And in the listbox 
Suffix Mappings, you should find the suffix 

• applescript as one of the entries (Figure 6). 
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Figure 6. Loolcing for the AppleScript codeless module. 


Now create a new document window liy cha:)sing New Text 
Document from the File menu. Then enter the text shown in 
Listing 5^ Notice the enteied text is still iincolored. 'Hits is because 
you have yet to save the docLuiient and assign tlie correct suOk. 

Listing 5- The test script, 

foobanapplescript 

(• 

Till'S Is a bltx;k comnienl 

*) 

property gRoot : "OS X:AppJIcations:Chess.app:Contents:" 


set tTest to path to documents folder 
set tTest to gRoot as string 

(* 

ITiis b another block comment 

*) 

tell application "Finder" 
set tPoo to —foo'^ 
set tBar to ''foo \''bar\” foo" 
kind of alias gRoot 
end tell 

— 'Jltis is an mllne comment 
to listRoo from aSrc 
local tLst 

tell application "System Events" 

set tLst to every itena of alias aSrc 
end tell — application "System Events'' 
end listFoo —from aSic 

(* Tills is a bo a block comment *) 
on listBartaSrc) 
local tLst 

tell application "Finder” 

set tLst to every file in alias aSrc as list 
end tell —application"Find" 
end listBar — (aSre) 

Go to ilie File menu und clioose ttie menu item Save As. Set 
tlie lile name to foobar^applescript, hyt leave the file 
location to your home directory. Click the Save button to cieate 
the script hie. Once BBEdil writes the script filen it aulomatically 
renders the text as shown in Figure 7. Furthermore, it marks the 
.start of each function block with a triangle icon and the end of 
each bkxk with an inveit-l icon. Clicking the triangle icon 
collapses the blcxk; clicking it again expands the block. Finally, 
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click the function pop-up list on the window. You will see the 
names listFoo and listBar appear on that list. 

int» !• o PioCK coegont 

prOtPv?ty pfloot . K Ac ' 

_ set tTMt to poth to dor«o«<^t 6 (oil 
oot iTe«i to gPoot o« airlro 

(• 

Thli »<1 or-ouw blocit eon p je t 

•) 

toU OppltCOtlOO 

set tfoo to t . 
set tSor to :> : r< 

ktod of olios gfloot 
•- end tel 1 

This is on inline cosssor* 
to listToo (roe oSrc 
▼ locol tLst 

tell (plication ■ 

set tLst to every iteo oi « 

V end tell oppiI'uwLtor Srstc- 

linc^rnn 4^— 

Figure 7. The rendered AppleScript script 


But note how BBEdit marks line 7 with a triangle icon. I’hLs 
Is incoiTect, of course, for tlie liiie does not start a function block. 
What happened here is tliat die keyword "to' has two roles; a 
prefix of a function block (line 14) or an assignment (lines 6 and 
7). Unfortunately, the codeless module could not difTerentiate 
between tliese two roles. One solution is to treat ' to' only as an 
assignment ke^T^'ord. A lx!tter way is to w^riie the m(>dule ;is a 
plug-in module. 

Preparing The Plug-in Module 

Now^ let us build our AppleScript module as a plug-in 
module. Start up Xcode and choase New Project from its File 
menu. Scroll down the list of project templates and chcxxse the 
template CFPlugin. Click the Next button and sSet the projeci 
name to AppleScript. Leave the project location set to your 
home direc:tor>'. Tlien click the Finish button to create the plug-in 
pR)ject. 

Go to die Groups & Files pane and selea die entry^ 
InfoPlist. strings. Set the key 

NSHrnnanReadableCopyright to die desired copyriglit text. 
Then choose Edit Active Target from die Project menu. Scroll 
down until you find the Packaging group. Change die vakie of 
the entry^ Wrapper Extension to bblm. Close die target setdngs 
window and save your changes. 

Next, switch to the Finder and go to the AppleScript 
project directory. Create an empty directory and name it 
Headers. To this directoryj copy the following header files from 
the BBEdit SDK, 

BBLMIuterface.h, EBXTInterface.h* 

BBXTlinpl ementationMaciroB ,h 


BBXTImp lamentation St ructsAndEiums. h 

Switch back to Xcode and choose Add to Project from the 
Xcode's Project menu. the Open FEe dialog to select the files 
inside the Headers directory, Click die Add button to accept 
these files. When you do, make sure you have AppleScript as the 
file's target. 

FinaEy choose New File from the EEe menu. Select C++ 
File from the Est of file templates. Click the Next button and set 
the file name to AppleScript. cp. Make sure to allow Xcode to 
aeate a header file. Then click the Finish button to create the 
project source file. When done, your project window should 
appear as shown in Figure B. 


I Craovi 


^ ]nioFJlKt.i1nnfi - Appie&cnpt 





aim- 




Figure 8, The Xcode project (AppleScriptxcodeproj]. 


The InfOaplist file 

Select the entiy^ Info.plist from the Groups & Files 
pane, Loaite the key CFBundleIdentifier; set its value to 
com-mactech.anarakisware,demo -applescript. If 
you prefer, you can supply ycjur ow^n unique bundle ID Next, 
set the key CFBundleSignature to BBLM. Then set the key 
CFBundleVersion to 1-O.Odl or to your own version 
string. Leave the rest of the CFBundle keys to their default 
values. 

Scroll dowm to the end of the Info-plist file^ and enter 
the key/value pairs show^n in Listing 6. This group defines the 
basic aspects of the plug-in, just like Listings I and 2. It also sets 
AppleScriptMain as the plugdns main entry^ function, 
which w^e will cover next. 

Listing 6, Describing the plug-in module. 
Info.plist 

< key>com.barebones.bbIminf c</key> 

^array) 

<[— Plug-in primer —> 

<key^BBLMLanguageCode(/kay) _ _ 

<Etring>foyS</St ring) 

<key >BBLMLanguageDl sp iayNaine< /key > 
<string>AppleSGript</string) 

< key) B BLMMa InFiinc 11D nU ame C / k e y) 
Cstring)AppleSrtlptMal[iC / string) 

<key> B B LM Su f fixMa p </key) 

<an:ay) 


70 JUNE *2010 


WWW.yACTtCH.COM 















<dlct> 

<key >BBLHLaTiguageSuf f ix< / key> 

<strin^> *applesci:±pt</string> 

<ydict> 

</array> 

<!— Plug-in uttribultfs —> 

<!— see Listing 7 —> 

<!— Reserved wtircLs —> 

<!— see Listing 8 — 

</dict> 

(/array) 

Next, enter the key/value pairs shown in 
Listing 7» This second group defines the 
plug-in’s behaviour. Our plug-in is expected 
to scan for function blocks and to color 
language keywords. It does not have to do 
case-sensitive tasks or guess the target 
language in use. But it does assume die path 
of the target file to be in POSIX fomi. 

Listing 7. Defining the plug¬ 
in’s behavior. 

Info.plist 

■U:ey>ccmi, barabones. bblminfo(/key> 
(array) 

(diet) 

<!— Plug4n primer —> 

<!— see Listing 6 —> 

<!— PJug-in atiril>utes —> 

(key>BBLMScansFunctions</key> 
(true/) 

(key)BBLMCanCu es s L an gua ge(/k ey > 
(false/) 

(key > BBLHColots Synt ax</key) 
(true/) 

<key)BBLMDroppedFilePathStyle(/key> 
(string>POSlX</string) 
<key>BBLMlsCaseSenBitive(/key> 
(true/) 

(key)BBLMUseKTMLFi1eSearcbln1e3(/key> 
(false/) 

<!— Rc.served words —> 

<I— see Listing 8 —> 

(/diet) 

(/array) 

Now enter the key/vaiue pairs in Listing 8. 
I'his group defines die core keywords diat 
make up the target language. It serves the 
same role as Listing 3 of the codeless 
module. 

Listing 8* Defining the 
language keywords 
(partial list). 

Info.plist 

<kyy>cotii.barebones,bbliiiiiifo(/key) 

(array) 

(diet) 


Listing 9. The main entry function. 

AppleScriptMainQ 

extern 

t 

OSErc AppleScriptMalnCBBLMPararaBlock &aArg 

, cunst BBLHCallbackBleck taBLM 
* const BBXTCallbackBlock EtaBXT) 

I 

OSErr result: 

// validate thtr parameter block 
if ((aAr^.fSignature t= kflBLHPars m HlockSignature) || 

(aArg. fVersion < kBBLMParajnBlockyersioiiS) 

I 

return paramErr: 

I 

// identify the plug-in message 
switch {aArg*fMessage) 

I 

case kBBLMInitMessage: 

// — the plug-in module bi Jiiading 
case kBBLMBieposeHessage: 

// — the plug-in module is unloading 
result ^ noErr: 
break: 

case kBBLHScanForFunctionsMesss &e: 

// — a iiat of function names Ls needed 
ASFunctionScanCaArg, aBLH); 
break: 

case kBBLMCalculateRufisMessage: 

// — a list of syntax runs is needed 
ASCalculateRunE (aArg, aBLM): 
break; 

case kBBLMAdjustRangeHessage: 

// — iJ\e indices of the first and last language run has changed 
case kBBLMAdjustEndKessage: 

// — die offset to the last txt charaaer has clianged 
case kBBLMMapRunKiadToColorCodeMessage: 

// — map a itser-defined run code to a run-color 
case kBBLHKapColorCodeToColorHessage; 

// — map a user-defined run color to an actual color 
case kBBLMEscapeStrlngMessage: 

// — tiandle an escape string character 
case kEBLMSetCategoriesMessage: 

// ^— configure character categories 
case kBBLMMatcbKeywordMessage: 

// — kx)k for a keyword match 
case kBBLHGuessLaUguageMessage: 

// — identify the target language 
result ^ userCanceledErr: 
break: 

default: 

if plug-in:message!unknown/unsupported 

t 

result = paramErrr 
break; 

1 

1 

return result: 

1 // OSErr AppieScriptMain 

] //extern "C" 
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Listing 10. Looking for function names. 

ASFunctionScan() 

OSErr ASFuncticr.Snan (BBLMParainBlock &aArg.. const BBLMCallbackSlock *aBLM} 
f 

GFRange tRng; 

CFIndex tLen^ tPos; 

CPStringRef tSrc. tLin^ tNom* 

CFStringTokeni^^erRef tSen, tWrd: 

CFStringTokenlzerTokenTypc tChk: 

OSErr tErr: 


// read tlie target teJct 

tSrc = CFStritigCteateWithChatnctcrs [kCFAllocatorDefault 
. [UnlChar*) aArg.fText 
, aArg,fTextLength); 

// parameter check 
tLen = CFStringGetLength(tSrc): 
if (tLen > 0) 


// create a line tokenizer 
tRng = CFRangeMakefOn tLen); 

tSen = CFStringTokenizetCreate(kCFAllocatorDefault 

. tSrc, tRng 

, kCFStrlngTokenizerlTnitParagraph 
, CFLocaleCopyCurrent()3; 

±f CtSan != NULL) 

I 

CFRange tFnd; 

// parse the source text 
tPos = 0; 

while (CFStringTokeiiiaerAdvanceToNextloken (tSen) 

!” kCFSttingTokenizerTokenNone) 

I 

// extract a source tine 

tRng ” CFStringToksnizerGetCtirrentTokenRange (tSen) ; 
tLin = CFStringCreateWlthSubstringCkCFAllocatorDefault 

, tSrc 
t tRng): 

// sciin the line for a Function prefix 
tFnd = CFStringFindCtLin. CFSTR("to"}. 0): 
if (tFnd.location = kOFMotFaiind) 

tFnd - CFStringFindCtLin. GESTRC^Qn"), 0): 


if 

I 


// was the check .successful? 

[tFnd.location = 0) 

// create a weird tokenixer 

tRng = CFRangeMake(0, CFStringGetLength(tLia) 3 I 
tWrd = CFStringTokenizeTCreatefkCFAllocatorOefault 
♦ tLin, tRng 

, kCFStringTokenlzertlnltWord 
, CFLocaleCopyCurrant()): 

if [tWrd !- PTULL) 

I 

// locate the function name 

tChk = CFStj:ingTokenizerAdvanceToNextTo.kan(tWrd] : 
tChk ° CFStringTokenLZGrAdvanCGToNextTokGn{tWtd) ; 
tRng 

- CFStrlngTokenizGrGetCurTentTokGnRange(tWrd]: 

tNora 

” CFStrlngCreateWithStibattlng (kCFAllocatorDefault 
. tLin 
. tRng): 

// updiite the function list 
tErr = ASFunctionLlst (aArg, aBLM. tfJom 

, [tFoa t 3)); 


I //{tWrd!=NULL) 
} // (tFndlocation — 0) 


// update the line position 
tPos += CFStringGetLength(tLin): 
I / / while(,..) 

I //{tSen!=NULL) 

] //(tLen>0) 

// return the Function results 
return (tErr): 

1 // OSErr ASFunctionScan() 


<1— Plug-in primer —> 

<!— see Listing 6—> 

<!— PLug-in attributes —> 

<!— see Listing 7 —> 

<!— Reserved words —> 

<key>BBLMKeyvordList</key> 

(array) 

<string>tGll(/atring) 

<strlng>on</Btring> 
<string>to</string) 


< strliig>end (/string) 

< strlng>rGturn< / string) 
<atring>considering</string) 
<atring>ignoring(/Etring) 
<string>tiTneout</string) 
<Btring>tranaactipn</Btring> 


<string>property(/atring> 

<string>global(/string) 

< St rlog>local(/string) 

<1— for the complete 
list, see the Xcode project —> 

(/array) 

(/diet) 

(/array) 

The main entry function 

Select the entry AppleScript .cp 
from the Groups & Fifes pane. Then 
enter the code shown in Listing 9 The 
code dehnes tlie basic structure of the 
main entry function 

AppleScript Main. The function takes 
three input arguments. The first 
argument is an instance of the 
BBLMParamBlock struct. This struct 
supplies the text data for the plug-in to 
process. It instrucLs the plug-in on how 
to process the data, and it tells the plug¬ 
in where to display the result. See Lisiing 
9 below. 

The second input argument is an 
instance of the struct 
BBLMCallbackBlock. This struct 
defines the utility methods that a 
language plug-in can use. As a rule, you 
^do'not access those methods directly 
from BBLMCallbackBlock. Use 
instead the various inline methods 
defined in the header file 
BBLMInterf ace.h. These inline 
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Listing 11. Listing the function names. 
ASFunctionListO 

OSErr ASEunctloriLifit{BBLMParainBlock &aArg« 
const BBLMCallbackBlock ‘aBLM 

, CFStringRef aUoii]. CFIndex aPos) 

I 

BBLMFrocInfo tinf; 

CFIndex tLeni 
Hint32 tldK = 0: 

OSErr tErr = userCanceledErr: 

// initUiIise the following IcK-als 
■LLen = CFStringGetkengthfaHora.): 

// reset the proc-info block 
meHLSet (firtinf, 0, slzeof (tlnf J); 

// set the following block fields 
tlnf.fFunctionstart = aPosj 

tinf.fFunctlonEnd = tinf.fFunctionStart + tLen; 

tinf.fSelStart - aPos^ 

tltif .fSelEnd = tlnf.fSelStart + tLen; 

tinf.fFlrstChar = aPos: 

tinf^flndentLevel = 0 ; 

tInf.fKind ^ kBBLMFunctionMark: 

tliif.fFlags 0: 

tinf. f^iaineStart = 0; 

tinf.fNameLength = tLen: 

// update the list buffer 
tErr ^ bblniAddCFStringTokenToBtjffer(aBLM 

, aA c g.fFcn Pa rams.fTo k enB uffe r 
» aNoiD 

( Sitlnf .fNameStart) ; 

if ( tErr = noErr ) 

tErr = bblinAddFunctionToList (aBLM 

. aArgpfFcnParams.fFcnLlst 
, tinf 
H Sitldx): 

// return die update result 
return (tErr); 


nieihods require the BBLMCallbackBlock as one of 
their inputs. 

The third input argument is an instance of the 
BBXTCallbackBlock struct. As stated earlier, this 
struct supplies the inline methods that the plug-in can 
use. Information about these inline methods can be 
found in the file BBXTinterface.h. 

Next, the main entry function uses an OSErr as its 
return value. BBEdit uses this value to find out how the 
plug-in handled its tasks. For instance, if the plug-in 
gets an older, incompatible version of 
BBLMParamElock, it returns a paramErr. If it 
ignores a specific message, it returns a 
userCanceledErr. If it handles a message without 
problems, it returns a noErr. For a list of other 
possible errors, consult the Carbon header file 
MacErrors.h. 

Finally, the main entry function checks the 
fMessage field of BBLMParamBlock. This field 
specifies the action that BBEdit wants the plugdn to do. 

The action can be a simple one like a start-up, or it can 
t>e something more complex like a function parse. The 
file BBLMinterface-h describes all pos.sible actions 
that a plug-in module can expect. The plug-in can 
choose to handle all these actions, or just the base 
subset. The AppleScript module, for instance, will 
handle only the actions 

kBBLMScanForFunctionsMessage and 

kBBLMCalculateRunsMessage. 

Now compile the project by choosing Build from 
the Build menu. Xcode will then create the plug-in 
bundle and name it AppleScript ,bbim. Switch to 
the Finder, locate and copy the bundle to BBEdit's 
assigned directory for its language modules. Remove 
the codeless module AppleScript .plist if one is 
in the directory. Restart BBEdit and check the 
Languages panel of its Preferences window. You should 
find AppleScript listed on the Installed languages widget. 

Handling The Plug-in Messages 

Since w^e have a working plug-in module, we are now 
ready to handle the various messages that BBEdit sends to 
our plug-in. To keep things simple, we will focus only on two 
messages: kBBLMScanForFunctionsMessage and 

kBBLHCalculateRunsMessage. BBEdit sends the first 
message when it wants a list of function names from die plug¬ 
in. It sends the second message when it wants the plug-in to 
identify specific regions of the target text. 

Scanning for functions 

To handle die message kBBLMScanFor 
FunctionsMessage, the plug-in runs the routine 
ASFunctionScan( ) (Lisdng 10). This routine lakes two 
input parameters, which are instances of BBLMParamBlock 


and of BBLMCallbackBlock. Its output is an OSErr 
constant. 

The routine starts by storing the target text into an 
instance of CFString. Then it creates an instance of 
CFStringTokenizer, passing the CFString object as input. It 
also configures the tokenizer to divide the target text into 
separate lines of code. Next, ASFunctiDiiScan( ) parses 
each line of target text. If a line starts with either a " to' or 
an ' on *, die routine extracts the line and uses it to create a 
second CFSttingTokenizer. Then it sets that tokenizer to 
divide the hoe into its constituent words. The routine extracts 
the second word after the ^to/on' prefix and passes the 
results to the routine ASFunctionLiBt ( ) . 

The ASFunctionList { ) routine (Listing 11) handles 
the update of BBEdit’s function pop-up (see Figure 2). It takes 
four parameters: the function name, its position on the text, 
and the same two stnicts that ASFunctionScan ( ) gets. 
Like ASFunctionScan(), the routine returns its result as an 
OSErr. 
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Listing 12. Handling the syntax run message. 

ASCakulaieRumO 

OSErr ASCalculateRuns(BBLMParamBlock &aArg 

, const BBLMCallbacJiBlock 
I 

CFRange tRng; 

GFlndex tLen* tPos e 
CFS tringRef tSrc, tLln; 

CFStringTokenlaerRef tSen; 

OSErr tErr = userCanceledErr; 

// read the tai;get text 

tSrc = CFStringCr6ateWithCharaeters{kCFAllocatorDGfaiilt 
, CllnlChar“) aArg.fText 
, aArg+fTexlLength): 

// i>aminetpe check 
tLen “ CFE-triDgGetLengthCtSrc): 
if (then > 0) 

I 

// create a line tokenizer 
tRng = CFRangsMakG(0» tLen); 

tSen = CFStringTokGni 2 erCreate(kCFAlio[iatorDefaTj,lt 

. tSrCp tRng 

, kC FS t ringTokeniz erUnitPara graph 
, CFLocaleCopyCurrentO); 

if (tSen != NULL) 

[ 

CFRange tEgn. tEnd; 

Boolean tBbc ^ false: 

BBLMRunKlnd tTyp; 

// pam; the source text 
tPos = 0: 

while (CFEt rlngTokenizerAdvanceToNextToken(tSen) 

!= kCFStringTokenizerTokenUone) 

// extract a .source line 

tRng = CF3tringTokenizerGetCarrentTokenRange(tSen); 
tLin = CFStringCreateWithSnbstring(kCFAllocatorDefaiilt 

, tSrc 
t tRng}: 

// checking for a hlock coniments 
if (tBbc) 

I 

// check for the end of block tixnmenis 

tEnd - ASScanElockGoraments(tLin, true): 

if (tEnd.location 1= kCFNotFoand) 

f 

H ineasunc tlie mn 

tTyp = kBBLMRiinlsBlockCoiiiment; 
tBgn*length = CFStringGetLengthCtLin]i 

// niark the run 

tErr - ASMsrkRun{aArgp aBLM, tTyp* tPoE. tBgn): 

// end the run 
tBbc = false: 

1 

1 

else 

[ 

// check for the stait of block ccanments 
tBgn = ASScanElockCammaiitB(tLin. false); 
tBbc ^ (tBgn.location kCFNctFound): 
if (tBbc) 

i 

// check for the end of block corruitents 
tEnd ASScanBiockConi]itents{tL±n* true) : 
if (tEnd*location E= kCFNotFotmd) 

( 

// measure the mn 

tTyp - kBBLMRunlsLineComment; 

Listing 12 continues 


The routine starts by preparing an empty 
instance of the BBLHProcInfo struct. It 
updates the fields in that struct with data 
showing the position of the function name. 
Then it calls the inline function 

bbImAddCFStringTokenToBuffer(), 
passing the function name and position as 
input. Finally, it calls tlie inline function 
bblmAddFunctionToList(), passing the 
BBLMProcInfo instance as input. Notice that 
both inline functions return an OSErr as their 
result. 

Scanning for syntax runs 

Now to handle the message 

kBBLMCalculateRunsMessage, the plug¬ 
in runs the routine ASCalculateRuns () 
(Listing 12). This routine also takes the 
instances of BBLMParamBlock and 

BBLMCallbackBlock as input. And it 
returns an OSErr as its result 

The ASCalculateRuns < ) method 
follows a similar code structure as 
ASFunctionScan(), It uses an instance of 
CFStringTokenizer to divide the source 
text into distinct lines of code. Then it tests if 
each line forms part of a block comment. If 
the test fails, the method tests if the line form 
an inline string or comment. When the line 
pa.sses either tests, ASCalculateRuns () 
calls the method ASMarkRun()- And 
ASCalculateRuns () passers the type of 
syntax run, its kjcation and length. 

The ASCalculateRuns () method uses 
the ASScanBlockComments () function 
(Listing 13) to identify a block comment. This 
function takes two input parameters: a source 
line and a Boolean flag. This flag tells the 
function if it should look for the start or end 
of a block comment. If the flag is sSet to 
FALSE, the functinn checks if the source line 
starts with a M *' token. If the flag is set to 
TRUE, the function checks if the source line 
ends with a ' *)' token. Then it returns its 
se^irch result as a CFRange. 

To look for inline strings or comments, 
ASCalculateRuns ( ) uses the 

ASScanInline( ) function (Listing 14). This 
function also takes two input arguments: a 
source line and a range. But it returns its 
search results as a BBLMRunKind. Note the 
input argument aRng is passed by reference. 
This allows ASScanInline () to update the 
argument with its its search results. 

ASScanInline () starts by looking for 
either a * —' or a '"' token in the source line. 
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A token means the line has or is an inline 
comment. A '" ' token means it has an inline 
string, [f the line contains either one, the function 
decides which token appeared first. Next, 
ASScanInline( ) scans the extent of the inline 
structure. In the case of an inline comment, the 
function simply looks for the end-of-line token. 
In the case of an inline string, the function looks 
for a closing '''' token. But it ignores any '"' 
token that comes after a ' \ . 

Listing 15 shows the utility function 
ASMarkRuns(). The function takes five input 
arguments, the first two being the instances of 
BBLMParamBlock and BBLMCallbackBlock. 
The other three arguments specify tiie type of 
run, its starting position, and its length. First, the 
function identifies what run it should process. 
Next, it calculates the actual position of the run 
in the source text and the number of characters 
contained. Then it calls the BBEdit function 
bblmAddRun (), which marks the run with the 
right text color. 

For reasons of length, ASMarkRuns () only 
handles three types of runs. For a list of other 
run types, check the enum BBLMRunKind in the 
header file BBLMInterf ace. h. Supporting 
these runs will be left as an exercise to the 
reader. 

Installation and testing 

Recompile the plugdn module by choosing 
Build from the Build menu. Then copy the 
AppleScript <bblm bundle into the directory 
-/Library/ApplicationSupport/ 
BBEdit/Language Modules, Make sure you 
remove the older bundle before copying the new 
one. If BBEdit is already running, choose Quit 
from its application menu. Then restart BBEdit 
and bring up its preferences window. Check the 
Languages preferences panel and see if 
AppleScript is still listed in the Installed 
Languages listbox. 

Now go to the File menu and click the sub¬ 
menu Open Recent sub-menu. Choose the entry 
foobar, appLescript to bring up the text file. 
Notice how BBEdit marks the block comments 
and some of Ehe inline comments to the right 
colour (Figure 11). But note that it failed to do 
the same for the other inline comments and all 
the inline strings. This is a side effect of ht5w 
BBEdit handles its text data, 

To improve display and typing performance, 
BBEdit inserts gaps within each block of text. 
These gaps contain non-readable characters and 
have arbitrary position and lengths. But both 
CFString and its associate routines are unable 
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Listing 12 continued. 

tBgn.length = CPStrlngGetLength(tLin); 

// rriiirk the mn 

tErr ^ ASMarkRLiE(aArg. aBLM. tTyp 

. tPos. tBgn); 

//end the run 
tBbc = false: 
f 

else 

I 

// save the run 
tBgn.location = tPos; 
tBgn.length = CFStringGetLength[tLin); 

I 

I 

else 

f 

// clieck ftir an inline conunent or string 
tTyp = ASScanlnlineitLin. : 

// mark the run 

tErr = ASMarkRuii(aArg, aBLM. tTyp. tPos, tBgn): 
i //if(tBbc) 

[ //if(tBbc) 

// upcble the line position 

tPos 1= CPStrlngGetLength(tLln): 

\ //wMe{..,J 
1 //(tSen!=iNLTLL) 

1 / / (tLen > 0) 

return (tErr); 
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Listing 13. Scanning for block comments. 

ASScanBlockCommentsO 

CFRange ASScanBlockCoramsntsfCFStriTJgRef aSrc, Boolean aEnd) 

[ 

CFRange tRng; 

Boolean tElg: 

// set the search position 

tRng = CFKangeMake(0. CFStringGetLength(aSrc)): 

// is this the start or the end of tlie search? 
if (aEnd) 

// run a back^^xird search 
tFlg = CFEtrlngFindWithOptions(aSrc 
. CFSTR(-*)") 

* tfing 

* kGFCompareBackvards || kCFGompareAnchored 
, fiftRng): 

else 

// run a forward search 
tFlg = CFStringFindWithOptions(aSrc 
. CFSTR(-(»"3 
. tRng 

, kCFCompareAnchored 
. &tRng): 

// return the parse results 
if (tFlg) 

return (tRng)i 

else 

return (GFRangeMake(kCFNotFound ^ 0)): 


Listing 14. Scanning for inline comments or strings. 

ASScanlnHnefJ 

EBLMunKlnd ASScanInlirLe(CFStringRef aLin< CFRange taRug) 
f 

CFRange tBic, tBst; 

CFIndex tLen: 

UnlGhar tChr : 

BBLMRunKind tTyp = kBBLMRunlsCode; 

// look for a starting token 
tBlc “ CFStringFindCaLin, CFBTR(*‘-"), 0) ; 
tBfit = CFStringFliid(flLiii. CFSTE("\”*'). 0): 

// validate tlie token positions 
if (tBlc.location = kCFNotFound) 

I 

if (tBst.location != kCFNatFaund) 

[ 

// locate the end ot die string 
CFIndcx tPosj 

tPos = tBst.location: 
then = CFStringGetLengthCaliu) - 1; 
while (tPos < tLen) 

I 

tChr = CFStringGetCbaracterAtIndex(aLir;, tPos); 
if {[tPoa > tBst.location) 

(tChr “ 0x22)) 

[ 

// read die preceding cliaracEer 
tChr = CFStringGetCharacterAtIndex(aLin. tPos - 1); 
if (tChr \= ax5c) 

_^eak; 

I 

tPosPi: 

I 

// measure tlie Jcngdi of die inline string 

Listing 14 continues 


to handle these gitps. Plus, BBEdit leaves these gaps 
in place when it supplies its text data to the plug-in 
module. So, the plug-in must know how to detect 
and remove these gaps before it processes a syntax 
run. 

Thankful Iyj the BBLMParamBlock struciure 
holds the gap information in two fields, The first 
field fTextGapLocation is the position of the gap 
from the first character of the target text. The 
second field fTextGapLength is the number of 
characters within that gap. Use these fields to strip 
off any gaps prior to handling the text. This will be 
left as an exercise to the readers. 

Another way to handle die gaps is to use 
BBLMTextlterator instead of 

CFStringTokenizerRef to parse the target text. 
BBLMTextlterator has a distinct advantage of 
being gap-aware. Again, consult the BBEdit SDK for 
examples on how' to use this custom iterator. 

Concluding Remarks 

Throughout this article, we examined how 
BBEdit handies a document WTitten in a specific 
computer language. We saw^ how it colors each 
language keyword or block, and how it lists any 
function names present. We even learned how it 
aids users move from one function block to 
another. 

Yet, we find that BBEdit does not support some 
niche languages such as AppleScript. So to address 
this lack, we learned how to write two types of 
language modules. One module uses BBEdit's 
ability to parse the target text; the odier handies the 
actual parsing. We also learned how to install and 
test either module on BBEdit. 

And that ends our coverage of BBEdit's 
language modules. You can find examples of other 
language modules from the Bare Bones web site at 
the following URL, http:/^Avw. barebones.com/support 
Abed i yfJ ug n_l i brcry.html 

My thanks go to Patrick Woolsey of Bare Bones 
Softw^are for his help in making a viable language 
plug-in. Special thanks goes to Seth Dillingham of 
MacroByte Resources for his insights on the gap 
issue and its effects on the language plug-in. 

Until next time, take care. 
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Listing 14 continued 

tLen = tPas ' tBst,lacatlon; 
aRng-)location - tBst.location - 1: 

aRng->lengtli = tLen: 

// stit l etum lyptf 
tTyp =* kEBLMRunlsDoubleEtring; 

I 

I 

else 

I 

if ([tBst.location I” kCFKotFound) 

(tBst. location < tBic. location)) 

I 

// kxjnie the end tlie siring 
CFIndex tPos: 

tPos = tBst►location: 

then ” CFStringGetLengthCaLin) ■ 1: 

while (tPos < then) 

I 

tChr = CFStringGetCharacterAtlndextaLln, tPos): 
if ((tPos > tEst.location) 

&& (tChr “= 0x22}) 

I 

// read die preceding character 
tChr ^ CFStrlngGetCharacterAtIadex(aLin, tPos ’ 1): 
if ftChr [= 0x5c) 
break; 

) 

tPos-H-: 

[ 

// measure tlie length of the inline .string 
then = tPos - iBst.location; 
aRng->location = tBst.location: 
aRng->length = then + 1: 

// set die return typt' 
tTyp = kBBLMlunlsDoubleStrlng: 

) 

else 

[ 

// measure the length of the inline block 
then “ CFStringGetiengthfaLin) - tBic,location ‘ 1; 
aRng'Mocation = tBic. location: 
aRng->length = tLen; 

// set the return type 
tTyp ^ kBBLMRunlsLineCominent: 


// lemm die scan residts 
return [tTyp): 

1 


Listing 15. Marking a syntax run. 
ASMarkRunQ 

OSErr ASMarkRun CBBLMParamBlock SiaArg 

, const BBLMCallbackBlock *aBLM 
, HUMunKind aTyp 
. CFTndex aPoa. CFRange aRng) 

[ 

CFIndex tPos, tLen; 
bool tChk: 

// stibuit Uie syntix mn 
nwltch (aTyp) 

I 

case kBBLhffiunlsUjieComent: 
case kBBLHRunlsDoubleString; 

tPos = aPos f aRng location: 
then = aRng,length: 

tChk = bhlmAddRunfaBLM, aArg. fLanguage 
. aTyp 

. tPos, then 
, false): 

break; 

case kBBldlRunlsBlockCoiiimerit: 
tPos = aRng.location; 
then ” aPos - tPos + aRng,length: 
tChk bblmAddPLLinfaBLM. aArg. fLangtiage 
, aTyp 

. tPos, then 
, false): 

break; 

default: 

tChk = true; 
break: 

1 

// return die mark lesults 
return (noErr): 
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created on my Mac, and used DdveWire as the media platform 
for testing (see 

Ever? 

For fun, [Ve restored several vintage Coca-Cola machines, 
and reworked a crusty old Pac-Mao arcade cabinet and put a 
PC running MAME inside, complete with working coin door 
and controls (it’s the only thing that runs Windows here). Is 
that tech or what? 

Where can we see a sample of your work? 

With a name like mine, all you need to do is Google me, 
and you'll see link after link of things that Eve worked on over 
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THE MACTECH SPOTLIGHT 


BOISY G. PITRE 


ht t p: /Avww. tee- boy. com / 


What is your company? 

Tee-Boy. 1 own the company, and we 
are located in the heart of Cajun Country 
in Southwestern Louisiana, 

What do you do? 

My designated title is "Lead 
Developer" but 1 also run the 
company and handle all aspects of 
the business. We focus on custom 
programming on a consultancy basis 
for the Mac. ildionc. and iPad 
plaLf{)rms, hut also liave a portlblio of 
products that we sell on (3ur website. 

How long have you been doing what you 
do? 

Professionally, I've been a software 
engineer for 18 years, [f you count my first 
exposure to computing and learning how' to program, 
it's more like 28 years. More recently, 1 fell in love with the 
Mac back in 2002 and started learning Cocoa and Objective-C 
then; I ve been rloing Mac programming now for 8 years. It's 
by far the best platform that I've worked on. 

What was your first computer? 

My very first computer was a KiK Tandy Color Computer 
2 (a.k.a. CoCo 2) from Radio Shack, followed shortly 
thereafter by a i‘2SK C ogu^ 3. At first I used a cassette recoidei 
to store and loadiIngrams uin^il I rould afford a disk drive 
unit. The (?bCo c^mie \\;itl>a l)UittdniBASl'^u^^g;i 2 rq|;e^ T 
later Icarne^ 680^ assembly; lanit^ge. then'moved onto the 
OS“9 (Micrui^arc, riot AppJel t^l^Matlng sysler^ Mosi: t^3ple 
are sui'^rised 1 ttdr^ieiiWiai to tins day 1 still have fuoi 
with the CoCb,- ilhd even run a reuo“Computing 
harrcIwaTe/solfware business- with a friend, 
j See lTftp:i^Ww.dcu^eh.cEmfWars later, my fir.Mac would he 
a TOOM’ffeeMac It still works today, ,' 

Are you Mac-only, or a multi-platfoim persoa^ 

I like working with Linux, and if it israbsolulel^j 
I can do Window^s, but 1 would much rather work oiii; 

In fact, we’re all Mac here at the office and a' 
house. Air home, w^e’re huge advocates for the pla 
..Vife and I counted the number of folks tliat we’vey^^^nally 




converted over to the Mac, and it’s well beyond 
two-dozen and still going up. 

What attracts you to working on the Mac? 

Two tilings: simplicity and elegance. 1'he 
Mac platform is frustration-free, beautiful to work 
in, and is a real pleasure to use. Apple has got it 
absolutely righi in niy opinion, and that is 
corroborated by the feedback that I get from 
others who have listened lo my advice and 
purchased a Mac, I cannot tell you how 
many frustrating liours I have spent trying 
to get things done on other platforms, 
only to find the Mac does those same 
tasks effortlessly. Another benefit for me 
is that the Mac is built on such a robust 
operating system platform, BSD. It’s 
almost a dichotomy that such a 
gorgeous and responsive user interface 
iiins atop a pcm^erjiil yet often-times 
misunderstood operating system 
platform, l>ut Apple has the secret sauce 
that makes these two concepts gel so well. 
You cannot help I ml admire the engineering 
effort that went into integrating all of this. 


Whafs the coolest thing about the Mac? 

The coolest thing for me is that it "just works,” It’s 
really that simple. 

What is the advice you'd give £o someone trying to get into 
this line of work today? 

First, I would say pay your dues by gaining some relevant 
programming experience. A formal education doesn’t hurt 
either. If you’re a prodigy, good for you, but a good grounding 
in theor)'^ and a lot of practice is a recipe for success. Second, 
always make your customej;,^dient or emplt^^er’s require^^nis 
a priority. Share their vision Tor their pFaiect and pur your 
whole heart into making them happy with ^^pur worl^d’hirj^v 
he passionate; it w ill show through yrj|r work ^^d you will 
Finally, be yOuraelf. Dtm’t pe afraid toy sht%cajil yotir 
uniqueness and youriipi'rsunalit}^" People to l^-'lrk with 
other Iniefesting people. ’ 

What's the ccHalest tech thing you'yeFdone using OS X? 

There are several^i^tngs, but,i 3 |) pooiest afiiieVemeiit was 
gettingmiy to act as a disk/i^nuna), and HtDI ,sc%ef to 
my CoCo 3 ifeing a |tr<>duia T Resigned an4lf^ rote called 
Drive Wire, I de^op^|jie h^fiSljEn^er sdi|^at(^4n ObjectiveT. 
C and Cocoa^ a^l Ti^-’ m^^MacMcesun’#QoQi& biddi^rl;, 
actually presen^d a fc.steiyat: rhe^WDC^ Scientific Pester 
Development ^sio]^hov\^c0ni,^ compiler ^oject tla^^^K 
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